Last updated on 15th October 2026

The network agent is not connected

If you're seeing the error:

The network agent for x is not connected. Please check its connection and try again.

Or similar, then most likely the agent is either not running, or currently unable to connect to our servers. (The deploy-agent commands below apply to the legacy Ruby agent — if you have not migrated yet, follow Migrating from the Ruby deploy-agent to network-agent.) You can run the following on the server that is running the agent, in order to check this:

$ deploy-agent status

Which will tell you whether the agent is running or not. If it isn't running, you can start it with the following command:

$ deploy-agent start

If it is running, you can debug the issue by using the following command which will show you the last ten lines of the log file:

$ tail -n 10 ~/.deploy/agent.log

And if necessary, you can restart the agent again with a --verbose flag:

$ deploy-agent start --verbose

To add additional logging to the log file.

If the agent was working before and stopped connecting on or after 17 March 2027, it most likely was not upgraded in time to collect its new certificate. See Upgrade your network agent before 17 March 2027.