Uninstall Firezone

This guide covers removing Firezone from your infrastructure — both the Gateway from your servers and the Client from end-user devices.

Uninstall the Gateway

Use the tab that matches how you deployed the Gateway. Each set of steps is the inverse of the matching install guide.

Reverses the Debian / Ubuntu install.

Remove the package, its config, and the systemd service:
```
sudo apt purge firezone-gateway
```

Remove any leftover state and configuration:

sudo rm -rf /var/lib/firezone /etc/firezone

Remove the Firezone APT repository and signing key:

sudo rm -f /etc/apt/sources.list.d/firezone.list \
     /etc/apt/keyrings/firezone.gpg
sudo apt update

Reverses the systemd install.

Stop and disable the service:

sudo systemctl disable --now firezone-gateway

Remove the service unit and reload systemd:

sudo rm -f /etc/systemd/system/firezone-gateway.service
sudo systemctl daemon-reload

Remove the binary, init script, token, and state:

sudo rm -rf /opt/firezone \
     /usr/local/bin/firezone-gateway-init \
     /etc/firezone \
     /var/lib/firezone

Reverses the Docker install.

Stop the container:
```
docker stop firezone-gateway
```
Remove the container and its volumes:
```
docker rm --volumes firezone-gateway
```
Remove the image:
```
docker rmi ghcr.io/firezone/gateway:1
```
Remove the state directory:
```
sudo rm -rf /var/lib/firezone
```

If you used the Docker Compose reference, run docker compose down --volumes from the directory with your docker-compose.yml instead of steps 1–2, then delete the compose file.

Reverses the NixOS install.

In your system configuration, remove the services.firezone.gateway block and the inputs.firezone.nixosModules.gateway import (and, if you no longer need them, the firezone flake input and the Firezone substituter settings).
Rebuild to stop and remove the service:
```
sudo nixos-rebuild switch
```

Remove the runtime state and the token secret you created:

sudo rm -rf /var/lib/firezone /var/lib/secrets/firezone-gateway-token

Reverses the standalone install.

Stop the Gateway process (Ctrl-C in its terminal, or kill it).
Remove the binary you downloaded and any state it created:
```
sudo rm -rf ./firezone-gateway-* /var/lib/firezone
```

If you added the masquerading and forwarding rules, remove them (the forwarding sysctls reset on reboot):

sudo iptables -D FORWARD -i tun-firezone -j ACCEPT
sudo iptables -D FORWARD -o tun-firezone -j ACCEPT
sudo iptables -t nat -D POSTROUTING -o e+ -j MASQUERADE
sudo iptables -t nat -D POSTROUTING -o w+ -j MASQUERADE
sudo ip6tables -D FORWARD -i tun-firezone -j ACCEPT
sudo ip6tables -D FORWARD -o tun-firezone -j ACCEPT
sudo ip6tables -t nat -D POSTROUTING -o e+ -j MASQUERADE
sudo ip6tables -t nat -D POSTROUTING -o w+ -j MASQUERADE

Delete the "Firezone" shortcut from %APPDATA%/Microsoft/Windows/Start Menu/Programs/Startup/
Quit Firezone.
Open the Start Menu. Search for Add or remove programs and open it.
In the Add or remove programs dialog, search for Firezone.
Click on Firezone and click Uninstall.

macOS

Quit the Firezone Client.
Drag the Firezone icon from the Applications folder to the Trash.
Empty the Trash.

See Apple's documentation "Uninstall apps on your Mac" for more information.

Linux

Remove the auto-start link: firezone-client-gui debug set-autostart false
Quit Firezone Client if it's running.
Remove the package: sudo apt-get remove firezone-client-gui

Android

On Android and ChromeOS:

Go to the device's home screen.
Swipe up to open the app drawer.
Long-press the Firezone app icon. A menu will appear.
Tap App info in the menu. This will show the app info screen for Firezone.
Tap Uninstall. Android will show a dialog asking, Do you want to uninstall this app?.
Tap OK.

iOS

On iOS and iPadOS:

Long-press the Firezone app icon on the device's home screen.
Tap Remove App.
Tap Delete App. iOS will show a dialog asking, Delete "Firezone"? Deleting this app will also delete its data.
Tap Delete.

For headless Clients, stop the process and delete the binary you downloaded; if you configured it as a service, remove that unit too.

Need help? See all support options.

Uninstall Firezone

Uninstall the Gateway

Delete the Gateway from the admin portal

Uninstall the Clients

Windows

macOS

Linux

Android

iOS