Runner troubleshooting
Start with these three commands. They answer most questions:
champrep-code-runner version # which version is installedchamprep-code-runner verify # is the token still validchamprep-code-runner service status # is the service runningCommon problems
Section titled “Common problems”| Symptom | What to do |
|---|---|
command not found: champrep-code-runner | The install folder is not on your PATH. Open a new terminal, or add /usr/local/bin or ~/.local/bin (Windows: %LOCALAPPDATA%\CHAMPREP\bin) to PATH. |
no runner is registered on this machine yet | Register it first: champrep-code-runner register --url https://code.champrep.com. |
a runner authentication token is required | Pass the token: run register in a terminal to be asked for it, or use --token-stdin. |
the token is not a runner authentication token (ccrt_...) | You copied another kind of token. Create a runner in CHAMPREP Code and copy its ccrt_ token. |
runner disabled … invalid or expired | The token was deleted, reset or expired. Create a new runner token, register again, and remove the old entry with unregister --name NAME. |
| Jobs stay pending | Check that the job’s tags match the runner’s tags, that “Run untagged jobs” is on for untagged jobs, that the runner is not paused, and that a protected runner is only used for protected branches and tags. |
the server refused this runner | The runner is too old for a feature the job needs. Upgrade the runner. |
configuration file … is locked | Another run is already using this configuration. Stop it first. |
git 2.24 or later is required | Install a newer Git. |
| The service stops right after starting | Read the service logs (see Runner commands). With --user, that user may not be able to read the configuration folder. |
Access is denied when installing the service (Windows) | Run PowerShell as administrator. |
Runner or CLI?
Section titled “Runner or CLI?”champrep-code-runner runs CI/CD jobs. champrep is the CHAMPREP CLI for
working from your terminal. If a command is not recognised, check you are using
the right program: see Runner or CLI?.
Still stuck?
Section titled “Still stuck?”Contact support with the output of champrep-code-runner version
and the error message. Never share your runner token.