Skip to content
Documentation

Runner troubleshooting

Start with these three commands. They answer most questions:

Terminal window
champrep-code-runner version # which version is installed
champrep-code-runner verify # is the token still valid
champrep-code-runner service status # is the service running
SymptomWhat to do
command not found: champrep-code-runnerThe 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 yetRegister it first: champrep-code-runner register --url https://code.champrep.com.
a runner authentication token is requiredPass 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 expiredThe token was deleted, reset or expired. Create a new runner token, register again, and remove the old entry with unregister --name NAME.
Jobs stay pendingCheck 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 runnerThe runner is too old for a feature the job needs. Upgrade the runner.
configuration file … is lockedAnother run is already using this configuration. Stop it first.
git 2.24 or later is requiredInstall a newer Git.
The service stops right after startingRead 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.

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?.

Contact support with the output of champrep-code-runner version and the error message. Never share your runner token.