> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://nemo-platform.docs.buildwithfern.com/nemo/platform/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://nemo-platform.docs.buildwithfern.com/nemo/platform/_mcp/server.

# Troubleshooting

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