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.