---
title: "Troubleshooting"
description: ""
---
This page covers common issues and how to resolve them.

## Command Not Found

### Unknown command: nemo

**Symptoms:**
- `nemo: command not found`
- `Unknown command: nemo`

**Cause:**

If you installed `nemo-platform` with `pip` or `uv pip`, it was installed in a virtual environment. The `nemo` command is only available when that environment is activated.

**Solution:**

Activate the virtual environment where you installed the package:
```bash
source /path/to/venv/bin/activate
```

## Connection Issues

### Unable to Connect to Server

**Symptoms:**
- `Connection refused` or `Connection timed out` errors
- Commands hang or fail with network errors

**Solutions:**

1. Verify the base URL is correct:

    ```bash
    nemo config view
    ```

2. Check that the server is reachable:

    ```bash
    curl <your-base-url>/health
    ```

3. If running locally, ensure services are up:

    ```bash
    curl -s http://localhost:8080/health/ready
    ```

### Authentication Errors

**Symptoms:**
- `401 Unauthorized` or `403 Forbidden` errors
- `Invalid API key` messages

**Solutions:**

1. Verify your credentials are configured:

    ```bash
    nemo config view
    ```

2. Re-configure the connection:

    ```bash
    nemo config set --base-url https://nmp.example.com
    nemo auth login
    ```

3. Check that your API key is valid and has the required permissions.

## Debugging

### Enable Verbose Output

Use the `--verbose` flag to see detailed information about what the CLI is doing:

```bash
nemo --verbose workspaces list
```

This shows:
- API requests being made
- Response details
- Configuration values being used

### Check Current Configuration

View your full configuration to verify settings:

```bash
nemo config view
```

## Getting Help

- Use `--help` on any command for usage information
- See the [reference](/documentation/reference/cli-reference/full-cli-reference) for complete command documentation
- See [configuration](/documentation/reference/cli-reference/configuration) for detailed configuration options
