Troubleshooting

No active profile

Run ign profile list, then ign profile use dev with the intended profile name. Check that the environment variable referenced by the profile is set in the shell running ign.

Authentication rejected

Run ign doctor. For an Ignition 8.3 native REST endpoint, use the full API token in name:key form. A 401 indicates rejected authentication. A 403 indicates that the token was recognized but the requested access was refused. Check the token's security level, gateway permissions, and HTTPS requirements.

WebDev routes are missing

The CLI requires its own route bundle for runtime tags, alarms, and history. Read the WebDev section of the reference before running ign webdev deploy. Deploying replaces the CLI-owned route project.

Import or resource update behaves unexpectedly

Some resource edits use an export / overwrite-import cycle for the whole project. Concurrent Designer changes can be replaced. Read the command's operation notes and inspect a development copy before applying the operation to shared work.

For a bug report, include ign version, the subcommand, gateway version, and a redacted error. Open an issue.