> ## Documentation Index
> Fetch the complete documentation index at: https://docs.koalavault.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# koava status

> Check authentication status and server connection

# Usage

```bash theme={"system"}
koava status
```

For help:

```bash theme={"system"}
koava status -h
```

# Description

Shows your KoalaVault authentication status, user info, and server connection status.

It also shows the Hugging Face CLI status, which is important because the `push` command requires Hugging Face CLI to be logged in, as it automatically creates public models on Hugging Face and uploads encrypted models there.

<Note>
  The `status` command automatically detects Hugging Face CLI status by calling `hf auth whoami`.
</Note>

# Examples

## Check Status

```bash theme={"system"}
koava status
```

Normal output (everything working):

```
Status
------
Version: 0.0.11
Authentication: Authenticated
Username: koalavault
Email: koalavault@koalavault.ai
Server: Connected
Hugging Face CLI: Logged in as KoalaVault
```

## Authentication Issues

**Not authenticated:**

```bash theme={"system"}
koava status
# Authentication: Not authenticated
```

**Solution:** Run `koava login`

## Server Connection Issues

<Expandable title="Server Connection Issues">
  **Connection failed:**

  ```bash theme={"system"}
  koava status
  # Server: Connection failed (Network error: error sending request for url (https://api.koalavault.ai/api/health))
  ```

  **DNS resolution failed:**

  ```bash theme={"system"}
  koava status
  # Server: Connection failed (DNS resolution failed - check endpoint URL)
  ```

  **Connection refused:**

  ```bash theme={"system"}
  koava status
  # Server: Connection failed (Connection refused - server not running?)
  ```

  **Connection timeout:**

  ```bash theme={"system"}
  koava status
  # Server: Connection failed (Connection timeout - server unreachable)
  ```

  **Certificate issues:**

  ```bash theme={"system"}
  koava status
  # Server: Connection failed (Certificate verification failed)
  ```
</Expandable>

## Hugging Face CLI Issues

<Expandable title="Hugging Face CLI Issues">
  **CLI not found:**

  ```bash theme={"system"}
  koava status
  # Hugging Face CLI: Not found
  ```

  **CLI found but not logged in:**

  ```bash theme={"system"}
  koava status
  # Hugging Face CLI: Found (not logged in)
  ```

  **CLI logged in (normal):**

  ```bash theme={"system"}
  koava status
  # Hugging Face CLI: Logged in as username
  ```
</Expandable>

## User Information Issues

**No username/email (when not authenticated):**

```bash theme={"system"}
koava status
# Username: -
# Email: -
```

# Related Commands

* [koava login](/koava/login) - Authenticate with API key
* [koava logout](/koava/logout) - Clear stored credentials
* [koava config](/koava/config) - Configure server endpoint and settings
* [koava push](/koava/push) - Complete workflow with Hugging Face integration