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