import SupportOptions from "@/components/SupportOptions"; import { TabsGroup, TabsItem } from "@/components/Tabs"; import Image from "next/image"; import Alert from "@/components/DocsAlert";

Troubleshooting Guide

Start with this guide for solutions to common issues faced by Firezone admins and end-users.

<Alert>

Note: To troubleshoot the Firezone client apps, see their respective troubleshooting guides in the Client App documentation.

</Alert>

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:

bash

sudo systemctl status firezone-gateway

Check the logs with:

bash

sudo journalctl -u firezone-gateway.service

</TabsItem> <TabsItem title="Docker">

Check that the container is running:

bash

docker ps --filter "name=firezone-gateway"

Check the container logs:

bash

docker logs firezone-gateway

</TabsItem> <TabsItem title="systemd">

Check the status of the service:

bash

sudo systemctl status firezone-gateway

Check the logs:

bash

sudo journalctl -u firezone-gateway.service

</TabsItem> </TabsGroup> <SupportOptions />