Troubleshooting Guide
Start with this guide for solutions to common issues faced by Firezone admins and end-users.
Gateway not connecting
If you're trying to deploy a new Gateway and it's not connecting, try running some of the troubleshooting commands below to diagnose the issue.
If you deployed the Gateway using one of our Terraform examples, the Gateways are configured using the systemd deployment method.
Obtain a shell on the affected Gateway and check the status of the service:
sudo systemctl status firezone-gateway
Check the logs with:
sudo journalctl -u firezone-gateway.service
Check that the container is running:
docker ps --filter "name=firezone-gateway"
Check the container logs:
docker logs firezone-gateway
Check the status of the service:
sudo systemctl status firezone-gateway
Check the logs:
sudo journalctl -u firezone-gateway.service
Need additional help?
See all support options or try asking on one of our community-powered support channels:
- Discussion forums: Ask questions, report bugs, and suggest features.
- Discord server: Join discussions, meet other users, and chat with the Firezone team
- Email us: We read every message.
Or try searching the docs: