11. Troubleshooting
| Symptom | Likely Cause / Fix |
|---|---|
error: profile "<name>" not authenticated. Run: panctl auth login ... |
The session for that profile has never logged in or has been logged out. Run auth login again. |
error: profile "<name>" not found in ~/.panctl/profiles.toml |
Check for a typo in --profile or PANCTL_PROFILE, or the profile was never created. |
error: -f <file\|-> is required |
This command needs a JSON body; pass a file path or - to read from standard input. |
error: <field> is required |
A required positional argument or flag is missing. |
error: session expired. Run: panctl auth login --profile <name> |
Automatic renewal failed (e.g., the refresh token itself expired). Log in again. |
dial tcp ...: connection refused |
The appliance is unreachable; check the server address, network path, and firewall rules. |
An error: message with a raw JSON body |
This is the API’s own error response passed through unmodified. Pipe it through jq for easier reading, e.g. panctl volumes create ... 2>&1 | jq . |
This guide reflects the command set and behavior of PanCTL as of the version documented in the pan-ctl repository. Run panctl <command> --help for the most current flag list on your installed version.