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.

Check that the container is running:

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

Check the container logs:

docker logs firezone-gateway

Some browsers break DNS routing

Some web browsers enable DNS-over-HTTPS by default, which can interfere with Firezone's DNS-based routing system. If you're experiencing issues connecting to DNS Resources in your browser, or notice that DNS resources aren't being routed through a Firezone Gateway when they should be, try disabling DNS-over-HTTPS using the appropriate method below.


  1. Go to about:preferences#privacy in the address bar.
  2. Scroll down to the "DNS over HTTPS" section.
  3. Ensure that "Off" is selected.
Firefox DNS-over-HTTPS settings


  1. Go to chrome://settings/security in the address bar.
  2. Scroll down to the "Advanced" section.
  3. Ensure that "Use secure DNS" is disabled.
Firefox DNS-over-HTTPS settings

Need additional help?

See all support options or try asking on one of our community-powered support channels:

Or try searching the docs:
Last updated: June 20, 2024