# Troubleshooting

> Troubleshooting - See an 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-10-09T14:05:24.527896+00:00` (UTC).

## Primary page

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

## Sections on this page

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

## Related documentation

- [Agentic AI](https://docs.datarobot.com/en/docs/agentic-ai/index.html.md): Linked from this page.
- [DataRobot CLI](https://docs.datarobot.com/en/docs/agentic-ai/cli/index.html.md): Linked from this page.
- [Getting started - Common issues: dr: command not found](https://docs.datarobot.com/en/docs/agentic-ai/cli/getting-started.html.md#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.md#browser-doesnt-open): Linked from this page.
- [Configuration - Troubleshooting](https://docs.datarobot.com/en/docs/agentic-ai/cli/configuration.html.md#troubleshooting): Linked from this page.
- [Templates command - Template selection screen](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/templates.html.md#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.md#keyboard-controls): Linked from this page.
- [dr run - Error handling](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/run.html.md#error-handling): Linked from this page.
- [dr task - Error handling](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/task.html.md#error-handling-compose): Linked from this page.
- [DataRobot experimentation plugin - Access the GUI](https://docs.datarobot.com/en/docs/agentic-ai/cli/local-experimentation/index.html.md#access-the-gui): Linked from this page.
- [Local tracing - Tracing troubleshooting](https://docs.datarobot.com/en/docs/agentic-ai/cli/local-experimentation/experimentation-tracing.html.md#tracing-troubleshooting): Linked from this page.
- [Batch agent evaluation](https://docs.datarobot.com/en/docs/agentic-ai/cli/local-experimentation/experimentation-evaluation.html.md): Linked from this page.
- [dotenv command - Error handling](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/dotenv.html.md#error-handling): Linked from this page.
- [Command reference - Global flags](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/index.html.md#global-flags): Linked from this page.
- [self command](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/self.html.md#config): Linked from this page.
- [Agentic AI troubleshooting](https://docs.datarobot.com/en/docs/agentic-ai/agentic-develop/agentic-troubleshooting.html.md): 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 |

## Experimentation plugin (dr xp)

| Issue | Where to look |
| --- | --- |
| Install plugin, configure, start dashboard, open browser, ports | DataRobot experimentation plugin - Access the GUI |
| Port conflicts, missing entity ID, plugin not found | DataRobot experimentation plugin - GUI access troubleshooting |
| No traces, filter, and search | Local tracing - Tracing troubleshooting |
| Enable batch evaluation (--enable-evaluation), no Evaluation tab, judge errors | Batch agent evaluation |
| Evaluation APIs return 404 | Batch agent evaluation - Enable batch evaluation workflows |

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