Uninstall Firezone Gateway

This guide covers how to uninstall the Firezone Gateway from your server(s).

Step 1: Stop the Gateway and remove relevant files

Use the appropriate instructions below to stop and remove the Gateway depending on how it was installed:

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 cache directory:
```
sudo rm -rf /var/lib/firezone
```

Stop the service:
```
sudo systemctl stop firezone-gateway
```

Disable the service:

sudo systemctl disable firezone-gateway

Remove all relevant files:

sudo rm -rf /etc/systemd/system/firezone-gateway.service \
     /usr/local/bin/firezone-gateway \
     /usr/local/bin/firezone-gateway-init \
     /var/lib/firezone

Step 2 (optional): Delete the data from the admin portal

If you want to remove the Gateway's data from the admin portal as well, navigate to the Site where the Gateway was running, click (see all) next to the Online Gateways header, and then delete the offline Gateway corresponding to the Gateway you just uninstalled.

Need additional help?

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:

Last updated: May 15, 2024