Back to Firezone

Uninstall Firezone Gateway

website/src/app/kb/administer/uninstall/readme.mdx

1.0.51.6 KB
Original Source

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

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:

<TabsGroup> <TabsItem title="Docker" active>
  1. Stop the container:

    bash
    docker stop firezone-gateway
    
  2. Remove the container and its volumes:

    bash
    docker rm --volumes firezone-gateway
    
  3. Remove the image:

    bash
    docker rmi ghcr.io/firezone/gateway:1
    
  4. Remove the cache directory:

    bash
    sudo rm -rf /var/lib/firezone
    
</TabsItem> <TabsItem title="systemd">
  1. Stop the service:

    bash
    sudo systemctl stop firezone-gateway
    
  2. Disable the service:

    bash
    sudo systemctl disable firezone-gateway
    
  3. Remove all relevant files:

    bash
    sudo rm -rf /etc/systemd/system/firezone-gateway.service \
         /usr/local/bin/firezone-gateway \
         /usr/local/bin/firezone-gateway-init \
         /var/lib/firezone
    
</TabsItem> </TabsGroup>

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.

<SupportOptions />