# Troubleshooting
URL: https://docs.datarobot.com/en/docs/agentic-ai/cli/troubleshooting.html

> Index of common issues and where to find solutions in the DataRobot CLI documentation.

# Troubleshooting

## Troubleshooting

This page links to troubleshooting and common-issue sections across the CLI documentation.

## Installation and setup

| Issue | Where to look |
| --- | --- |
| "dr: command not found" | Getting started - Common issues: dr: command not found |
| "Failed to read config file" | Getting started - Common issues: Failed to read config file |
| Uninstalling the CLI | Getting started - Uninstalling the CLI |

## Authentication

| Issue | Where to look |
| --- | --- |
| "Authentication failed" | Getting started - Common issues: Authentication failed |
| Browser doesn't open for login | Auth command - Common issues: Browser doesn't open |
| Port already in use (OAuth) | Auth command - Common issues: Port already in use |
| Invalid credentials, connection refused, SSL issues | Auth command - Common issues |

## Configuration

| Issue | Where to look |
| --- | --- |
| Config not loading, invalid config, permission denied | Configuration - Troubleshooting |
| Multiple configs, state tracking | Configuration - State tracking |
| Environment variables | Configuration - Environment variables reference |

## Templates and setup wizard

| Issue | Where to look |
| --- | --- |
| Template selection (navigate, filter, directory prompt) | Templates command - Template selection screen |
| Interactive configuration and keyboard controls | Interactive configuration - Keyboard controls |

## Tasks and running

| Issue | Where to look |
| --- | --- |
| "Not in a DataRobot Template directory" / no .env | dr run - Error handling, Configuration - What counts as a template directory |
| Dotenv directive conflict (Taskfile) | dr run - Dotenv directive conflict |
| Task binary not found | dr run - Task binary not found |
| Tasks not found, env vars not loading | dr run - Troubleshooting |
| dr task compose errors | dr task - Error handling |

## Environment variables (dotenv)

| Issue | Where to look |
| --- | --- |
| Not in repository, missing .env, auth required | dotenv command - Error handling |
| Validation failures | dotenv command - Validation failures |

## Debugging

| Tip | Where to look |
| --- | --- |
| Verbose and debug output | Getting started - Getting help |
| Global flags (--verbose, --debug, --skip-auth) | Command reference - Global flags |
| View current config | dr self config — self command |

## Get help

- In-app help: dr --help , dr <command> --help
- Issues and discussions: GitHub Issues and GitHub Discussions
- Email: oss-community-management@datarobot.com

## See also

- Getting started
- Command reference
- Configuration
- Using Agentic AI templates? If you're building or running agentic workflows, see Agentic AI troubleshooting for agent-specific issues (prerequisites, deployment, local testing).

---
