# Troubleshooting

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

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-05-06T18:17:09.553567+00:00` (UTC).

## Primary page

- [Troubleshooting](https://docs.datarobot.com/en/docs/agentic-ai/cli/troubleshooting.html): Full documentation for this topic (HTML).

## Sections on this page

- [Troubleshooting](https://docs.datarobot.com/en/docs/agentic-ai/cli/troubleshooting.html#troubleshooting): In-page section heading.
- [Installation and setup](https://docs.datarobot.com/en/docs/agentic-ai/cli/troubleshooting.html#installation-and-setup): In-page section heading.
- [Authentication](https://docs.datarobot.com/en/docs/agentic-ai/cli/troubleshooting.html#authentication): In-page section heading.
- [Configuration](https://docs.datarobot.com/en/docs/agentic-ai/cli/troubleshooting.html#configuration): In-page section heading.
- [Templates and setup wizard](https://docs.datarobot.com/en/docs/agentic-ai/cli/troubleshooting.html#templates-and-setup-wizard): In-page section heading.
- [Tasks and running](https://docs.datarobot.com/en/docs/agentic-ai/cli/troubleshooting.html#tasks-and-running): In-page section heading.
- [Environment variables (dotenv)](https://docs.datarobot.com/en/docs/agentic-ai/cli/troubleshooting.html#environment-variables-dotenv): In-page section heading.
- [Debugging](https://docs.datarobot.com/en/docs/agentic-ai/cli/troubleshooting.html#debugging): In-page section heading.
- [Get help](https://docs.datarobot.com/en/docs/agentic-ai/cli/troubleshooting.html#get-help): In-page section heading.
- [See also](https://docs.datarobot.com/en/docs/agentic-ai/cli/troubleshooting.html#see-also): In-page section heading.

## Related documentation

- [Agentic AI](https://docs.datarobot.com/en/docs/agentic-ai/index.html): Linked from this page.
- [CLI](https://docs.datarobot.com/en/docs/agentic-ai/cli/index.html): Linked from this page.
- [Getting started - Common issues: dr: command not found](https://docs.datarobot.com/en/docs/agentic-ai/cli/getting-started.html#dr-command-not-found): Linked from this page.
- [Auth command - Common issues: Browser doesn't open](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/auth.html#browser-doesnt-open): Linked from this page.
- [Configuration - Troubleshooting](https://docs.datarobot.com/en/docs/agentic-ai/cli/configuration.html#troubleshooting): Linked from this page.
- [Templates command - Template selection screen](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/templates.html#template-selection-screen): Linked from this page.
- [Interactive configuration - Keyboard controls](https://docs.datarobot.com/en/docs/agentic-ai/cli/template-system/interactive-config.html#keyboard-controls): Linked from this page.
- [dr run - Error handling](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/run.html#error-handling): Linked from this page.
- [dr task - Error handling](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/task.html#error-handling-compose): Linked from this page.
- [dotenv command - Error handling](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/dotenv.html#error-handling): Linked from this page.
- [Command reference - Global flags](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/index.html#global-flags): Linked from this page.
- [self command](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/self.html#config): Linked from this page.
- [Agentic AI troubleshooting](https://docs.datarobot.com/en/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html): Linked from this page.

## Documentation content

## 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).