Files
2026-05-14 21:37:25 -07:00

76 lines
1.6 KiB
Markdown

# Troubleshooting
## The Codex App Does Not Show The Plugin
Make sure you add the repository root as a local marketplace:
```text
/path/to/autodl-remote
```
The root must contain:
```text
.agents/plugins/marketplace.json
```
Do not add:
```text
/path/to/autodl-remote/plugins/autodl-remote
```
After adding the marketplace, fully quit and restart Codex App.
## The CLI Says `.autodl-remote.conf` Is Missing
Bind the current local project to a remote project directory:
```bash
autodl-remote bind --account autodl-gpu --remote /root/autodl-tmp/my-project
```
The config should look like:
```bash
ACCOUNT="autodl-gpu"
REMOTE_ROOT="/root/autodl-tmp/my-project"
```
## Old Config Files
Older experimental versions used fields such as `PROJECT_MODE`, `SSH_TARGET`, and `AUTO_PUSH_BEFORE_RUN`.
The current version does not read that format. Rename the old config and bind again:
```bash
mv .autodl-remote.conf .autodl-remote.conf.old
autodl-remote bind --account autodl-gpu --remote /root/autodl-tmp/my-project
```
## Password Login Hangs Or Fails
For password-based SSH, use prompt auth:
```bash
autodl-remote account add autodl-gpu --target root@host --port 2222 --auth prompt
```
If you need non-interactive password login on macOS, store the password in Keychain:
```bash
autodl-remote account password-save autodl-gpu
```
## Avoid Pulling Large Files
Do not run broad `get` or `sync-down` commands on model, checkpoint, dataset, or output directories unless you really want those files locally.
Prefer remote inspection:
```bash
autodl-remote tree . --depth 2
autodl-remote tail -- logs/train.log
autodl-remote cat -- results/metrics.json
```