Troubleshooting

While Hocus is in alpha, expect to encounter issues. As the web UI is still under development, error messages may not always be helpful. If you run into a problem, you should check the dev logs of the following services.

Control Plane

If you experience issues in the UI, such as a 500 error, refer to the control plane logs.

ops/bin/local-cmd.sh logs hocus-ui

Agent

For problems related to prebuilds, workspaces, Git repository connections, or prebuilds stuck in the Pending state, refer to the agent logs.

ops/bin/local-cmd.sh logs hocus-agent

SSH Connection Issues on MacOS

If you are using MacOS and you are unable to connect to a workspace via SSH, you may need to add your SSH key to the SSH agent.

ssh-add --apple-use-keychain ~/.ssh/id_ed25519