Skip to content

docs: Add troubleshooting for corrupted credentials file #591

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
muhsinking merged 2 commits into from
Mar 25, 2026
Merged

docs: Add troubleshooting for corrupted credentials file #591

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ba6383b
Add troubleshooting for corrupted credentials file
promptless[bot] Mar 24, 2026
aae3002
Merge branch 'main' into promptless/corrupted-config-troubleshooting
muhsinking Mar 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions flash/troubleshooting.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -118,6 +118,23 @@ Get a key: https://docs.runpod.io/get-started/api-keys
source ~/.bashrc
```

### Corrupted credentials file
Copy link
Copy Markdown
Contributor Author

@promptless promptless bot Mar 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Citation: PR #481 adds graceful handling for corrupted config.toml files in get_credentials() and set_credentials(). Previously, a corrupted file would crash at import time; now it's treated as no credentials found, showing the "No API key found" message.
View source


**Error:**
```
Error: ~/.runpod/config.toml is corrupted and cannot be parsed.
Copy link
Copy Markdown
Contributor Author

@promptless promptless bot Mar 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Citation: Error message text from src/runpod_flash/cli/entrypoint.py in this PR. The entrypoint catches TOMLDecodeError at import time and displays this clean error message instead of a raw traceback.
View source

Run 'flash login' to re-authenticate, or delete the file and retry.
```

**Cause:** The credentials file at `~/.runpod/config.toml` contains invalid TOML and cannot be read. This can also appear as "No API key found" even after a successful `flash login`.

**Solution:** Delete the credentials file and re-authenticate:

```bash
rm ~/.runpod/config.toml
flash login
```

### Invalid route configuration

**Error:**
Expand Down
Loading