{"id":1147,"date":"2026-11-22T13:00:00","date_gmt":"2026-11-22T13:00:00","guid":{"rendered":"https:\/\/vpslake.com\/blog\/?p=1147"},"modified":"2026-11-22T13:00:00","modified_gmt":"2026-11-22T13:00:00","slug":"install-firezone-ui-wireguard-ubuntu-22-04","status":"publish","type":"post","link":"https:\/\/vpslake.com\/blog\/2026\/11\/22\/install-firezone-ui-wireguard-ubuntu-22-04\/","title":{"rendered":"Install Firezone UI for WireGuard on Ubuntu 22.04"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">To install Firezone UI for WireGuard VPN on Ubuntu 22.04, deploy the current Firezone Gateway and manage it through the hosted Admin Portal. In about 10 minutes, your VPS can provide policy-controlled access to a private server, database, application, or subnet.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This guide uses Firezone\u2019s current architecture. Ubuntu runs the Gateway data plane; the Firezone portal handles sites, users, resources, and policies, so the old self-hosted dashboard and local HTTPS certificate steps are not required.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Prerequisites<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>A fresh 64-bit Ubuntu 22.04 (Jammy) VPS with internet access.<\/li>\n\n\n<li>A root shell or a sudo-enabled user connected over SSH.<\/li>\n\n\n<li>At least 1 vCPU and 1 GB of RAM for a small Gateway; plan additional resources for higher traffic or many clients.<\/li>\n\n\n<li>A route from this VPS to the private resource you want users to reach.<\/li>\n\n\n<li>A Firezone account, a browser for the Admin Portal, and a separate device for testing the Firezone Client.<\/li>\n\n\n<li>The current Gateway does not require a domain name, public dashboard, or local TLS certificate.<\/li>\n\n\n<li>A fresh <a href=\"https:\/\/vpslake.com\/buy-vps\">VPSLake Linux VPS<\/a> running Ubuntu 22.04.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Step 1: Update Ubuntu and install Gateway prerequisites<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Updating Jammy and installing the packet-filtering commands gives the Gateway the host capabilities it checks during startup.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo apt update\nsudo apt full-upgrade -y\nsudo apt install -y ca-certificates gnupg iptables ufw wget<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Confirm that this is Ubuntu 22.04 and that both IPv4 and IPv6 firewall commands are available:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>. \/etc\/os-release &amp;&amp; printf '%s\\n' \"$PRETTY_NAME\"\niptables --version\nip6tables --version<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Expected output identifies <code>Ubuntu 22.04<\/code> and prints an <code>iptables v1.x<\/code> version for each command. If you are already root, remove <code>sudo<\/code> from the commands below.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 2: Create a Firezone Site and Gateway token<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The Site defines which resources this Gateway can serve, while the token registers one specific Ubuntu host to that Site.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n\n<li>Sign in to the <a href=\"https:\/\/app.firezone.dev\/\" target=\"_blank\" rel=\"noopener\">Firezone Admin Portal<\/a>, or create an account.<\/li>\n\n\n<li>Open <strong>Sites \u2192 Add Site<\/strong>, name it something recognizable such as <code>Ubuntu-2204-VPS<\/code>, and save it.<\/li>\n\n\n<li>On the new Site page, select <strong>Deploy a Gateway<\/strong> and choose the Debian\/Ubuntu deployment instructions.<\/li>\n\n\n<li>Copy the single-owner token into a password manager until the authentication step is complete.<\/li>\n\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">The token is a credential for this Gateway, not your Ubuntu password. Do not paste it into shell history, a ticket, a repository, or a screenshot; create a new token for every additional Gateway.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 3: Add the Firezone APT repository<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The signed Firezone repository supplies the <code>firezone-gateway<\/code> package and lets Ubuntu receive future updates through APT.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo mkdir --parents \/etc\/apt\/keyrings\nwget -qO- https:\/\/artifacts.firezone.dev\/apt\/key.gpg | sudo gpg --dearmor --yes -o \/etc\/apt\/keyrings\/firezone.gpg\necho \"deb [signed-by=\/etc\/apt\/keyrings\/firezone.gpg] https:\/\/artifacts.firezone.dev\/apt\/ stable main\" | sudo tee \/etc\/apt\/sources.list.d\/firezone.list &gt; \/dev\/null\nsudo apt update\nsudo apt install -y firezone-gateway<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The <a href=\"https:\/\/www.firezone.dev\/kb\/deploy\/debian\" target=\"_blank\" rel=\"noopener\">official Debian and Ubuntu deployment guide<\/a> uses this repository and package name. A successful install ends without an <code>Unable to locate package<\/code> error.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Check that APT has a package candidate:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apt-cache policy firezone-gateway<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Expected output contains an installed or candidate version and a repository URL beginning with <code>https:\/\/artifacts.firezone.dev\/apt<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 4: Authenticate and start the Gateway<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Authentication connects this VPS to the Site; systemd then keeps the Gateway running across SSH disconnects and reboots.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Run the interactive authenticator and paste the token only when prompted:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo firezone-gateway authenticate<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Check the service and its tunnel interface:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo systemctl is-enabled firezone-gateway\nsudo systemctl is-active firezone-gateway\nsudo systemctl status firezone-gateway --no-pager -l\nsudo ip link show tun-firezone<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Expected output includes:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>enabled\nactive\nActive: active (running)<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The interface check should show <code>tun-firezone<\/code>. Return to <strong>Firezone Admin Portal \u2192 Sites \u2192 Ubuntu-2204-VPS<\/strong> and confirm that the Gateway is online.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 5: Apply a narrow Ubuntu firewall policy<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The Gateway normally initiates its control-plane and tunnel connections, so do not expose a public Firezone dashboard or add unnecessary inbound VPN ports.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Keep the current SSH session open while enabling UFW. On a server that uses the standard SSH port, run:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo ufw allow OpenSSH\nsudo ufw default deny incoming\nsudo ufw default allow outgoing\nsudo ufw --force enable\nsudo ufw status verbose<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Expected output includes <code>Status: active<\/code>, an allowed <code>22\/tcp<\/code> OpenSSH rule, denied incoming traffic by default, and allowed outgoing traffic. If SSH uses <code>YOUR_SSH_PORT<\/code> instead, allow it before enabling UFW:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo ufw allow YOUR_SSH_PORT\/tcp<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">For a restricted or stateless egress firewall, allow outbound HTTPS to Firezone and the STUN\/TURN traffic listed in Firezone\u2019s <a href=\"https:\/\/www.firezone.dev\/kb\/reference\/ports\" target=\"_blank\" rel=\"noopener\">ports and protocols reference<\/a>. A normal stateful VPS firewall does not need a new inbound rule for Firezone.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 6: Add a resource, policy, and client<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">An online Gateway is only the transport path; a Resource and an explicit Policy decide what an authenticated user may reach.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n\n<li>In <strong>Firezone Admin Portal \u2192 Sites \u2192 Ubuntu-2204-VPS \u2192 Resources<\/strong>, select <strong>Add a resource<\/strong>.<\/li>\n\n\n<li>Enter a descriptive name such as <code>Private-App<\/code> and an address such as <code>10.20.0.15<\/code>, <code>db.internal.example<\/code>, or <code>10.20.0.0\/24<\/code>. Choose the narrowest address that meets the requirement.<\/li>\n\n\n<li>If the resource should expose only one service, add a traffic restriction such as TCP port <code>443<\/code> or TCP port <code>22<\/code> in the resource form.<\/li>\n\n\n<li>Open <strong>Policies \u2192 New Policy<\/strong>, select the intended user group and resource, then save the policy. Firezone is default-deny until this rule exists.<\/li>\n\n\n<li>Install the Firezone Client on a test device, sign in with your account slug, and connect to the resource.<\/li>\n\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Before testing from the client, make sure the Gateway itself can reach the destination:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>curl --fail --silent --show-error --connect-timeout 5 -o \/dev\/null -w 'HTTP %{http_code}\\n' http:\/\/RESOURCE_IP:PORT\/<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Replace <code>RESOURCE_IP<\/code> and <code>PORT<\/code> with an HTTP service that is intentionally reachable from this VPS. A response proves the Ubuntu route works; it does not bypass the Firezone Policy.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Expected output from a healthy HTTP service is similar to:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP 200<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Verify Firezone on Ubuntu 22.04<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Run the local checks after connecting the client:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>sudo systemctl is-active firezone-gateway\nsudo ip link show tun-firezone\nsudo journalctl -u firezone-gateway -n 30 --no-pager<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Expected output begins with <code>active<\/code>, shows the <code>tun-firezone<\/code> interface, and contains recent log entries without repeated authentication or connection failures. The Admin Portal should show the Gateway online, and the Client should show the permitted resource as connected.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">From the test device, open the approved web service or connect to the approved SSH\/RDP address. That end-to-end test confirms the client identity, policy, Gateway tunnel, route, and destination firewall are working together.<\/p>\n\n\n\n<aside class=\"vl-element vl-cta-banner\" aria-label=\"Deploy a secure Firezone Gateway\">\n\t<div class=\"vl-cta-banner__content\">\n\t\t<p class=\"vl-cta-banner__eyebrow\">Ubuntu 22.04 VPS<\/p>\n\t\t<h3 class=\"vl-cta-banner__title\">Deploy a secure Firezone Gateway<\/h3>\n\t\t<p class=\"vl-cta-banner__text\">Start your WireGuard-based private access gateway on a clean Ubuntu 22.04 VPS.<\/p>\n\t<\/div>\n\t<a class=\"vl-cta-banner__button\" href=\"\/buy-vps\" aria-label=\"View VPS plans\">View VPS plans<\/a>\n<\/aside>\n\n\n\n<h2 class=\"wp-block-heading\">Troubleshooting<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><code>Unable to locate package firezone-gateway<\/code><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">APT has not loaded the Firezone repository, or the list file and signing key do not match. Repeat Step 3, run <code>sudo apt update<\/code>, and check <code>apt-cache policy firezone-gateway<\/code>; a candidate should come from <code>artifacts.firezone.dev<\/code>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><code>gpg: no valid OpenPGP data found<\/code><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The key request returned an error page or no data, commonly because DNS, outbound HTTPS, or a proxy blocked <code>artifacts.firezone.dev<\/code>. Check connectivity with <code>getent hosts artifacts.firezone.dev<\/code> and <code>curl -I https:\/\/artifacts.firezone.dev\/apt\/key.gpg<\/code>, then fix egress and rerun Step 3.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">The Gateway is installed but remains offline<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Inspect the service log with <code>sudo journalctl -u firezone-gateway -n 50 --no-pager<\/code>. DNS failures, blocked outbound TCP 443, and an already-claimed single-owner token are common causes; correct network access or create a fresh token under <strong>Sites \u2192 YOUR_SITE \u2192 Gateways<\/strong> and authenticate this host once.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">The client connects but the resource cannot be reached<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Check the resource address, traffic restrictions, and Policy group first. Then test the destination directly from Ubuntu; the Gateway needs a route to it, and the destination\u2019s own firewall must allow the resulting traffic.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Hardening and maintenance<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>Restrict SSH at the VPS provider firewall to trusted source addresses and use SSH keys instead of password authentication.<\/li>\n\n\n<li>Treat the token and <code>\/var\/lib\/firezone<\/code> as sensitive. Rotate the token in the portal if it was exposed, then re-authenticate the Gateway.<\/li>\n\n\n<li>For an SSH baseline, review the generated rules from VPSLake\u2019s <a href=\"https:\/\/vpslake.com\/sshd-hardening-generator\">SSH hardening generator<\/a> before applying them to a production host.<\/li>\n\n\n<li>Update the Gateway through APT and check the service after each upgrade:<\/li>\n\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>  sudo apt update\n  sudo apt install --only-upgrade firezone-gateway\n  sudo systemctl is-active firezone-gateway<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">FAQ<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Is Firezone the same as a traditional full-network VPN?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">No. Firezone normally publishes named Resources and grants them through Policies, so a user does not automatically receive access to every address behind the Gateway. You can define a CIDR Resource when broad private-network access is intentional, but narrow host or service Resources are easier to control.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Do I need to install WireGuard separately on Ubuntu 22.04?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">No. The Gateway package supplies the Firezone data-plane components and manages the WireGuard-based tunnel itself. Installing a separate hand-written <code>wg0<\/code> profile is not part of this deployment.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Can I browse to the Ubuntu server to open the Firezone UI?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">No local dashboard is created by this method. Use the hosted Admin Portal for Sites, Gateways, Resources, Policies, and users; the Ubuntu server only runs the Gateway service.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Do I need a domain and Let\u2019s Encrypt certificate?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">No. The current Gateway connects outbound to Firezone and does not publish a local HTTPS control panel. A domain and certificate would be relevant to a separate web application you expose through a Resource, not to this Gateway installation.<\/p>\n\n\n\n<script type=\"application\/ld+json\">{\"@context\": \"https:\/\/schema.org\", \"@type\": \"FAQPage\", \"mainEntity\": [{\"@type\": \"Question\", \"name\": \"Is Firezone the same as a traditional full-network VPN?\", \"acceptedAnswer\": {\"@type\": \"Answer\", \"text\": \"No. Firezone normally publishes named Resources and grants them through Policies, so a user does not automatically receive access to every address behind the Gateway. You can define a CIDR Resource when broad private-network access is intentional, but narrow host or service Resources are easier to control.\"}}, {\"@type\": \"Question\", \"name\": \"Do I need to install WireGuard separately on Ubuntu 22.04?\", \"acceptedAnswer\": {\"@type\": \"Answer\", \"text\": \"No. The Gateway package supplies the Firezone data-plane components and manages the WireGuard-based tunnel itself. Installing a separate hand-written `wg0` profile is not part of this deployment.\"}}, {\"@type\": \"Question\", \"name\": \"Can I browse to the Ubuntu server to open the Firezone UI?\", \"acceptedAnswer\": {\"@type\": \"Answer\", \"text\": \"No local dashboard is created by this method. Use the hosted Admin Portal for Sites, Gateways, Resources, Policies, and users; the Ubuntu server only runs the Gateway service.\"}}, {\"@type\": \"Question\", \"name\": \"Do I need a domain and Let\u2019s Encrypt certificate?\", \"acceptedAnswer\": {\"@type\": \"Answer\", \"text\": \"No. The current Gateway connects outbound to Firezone and does not publish a local HTTPS control panel. A domain and certificate would be relevant to a separate web application you expose through a Resource, not to this Gateway installation.\"}}]}<\/script>\n\n","protected":false},"excerpt":{"rendered":"Install Firezone UI for WireGuard VPN on Ubuntu 22.04 as a Gateway, secure SSH with UFW, and verify private resource access in minutes today.","protected":false},"author":1,"featured_media":1148,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"csco_singular_sidebar":"","csco_page_header_type":"","csco_page_load_nextpost":"","footnotes":""},"categories":[5,9],"tags":[146,101,148,147],"class_list":["post-1147","post","type-post","status-publish","format-standard","has-post-thumbnail","category-guides","category-vps-hosting","tag-firezone","tag-ubuntu-22-04","tag-vpn","tag-wireguard","cs-entry"],"_links":{"self":[{"href":"https:\/\/vpslake.com\/blog\/wp-json\/wp\/v2\/posts\/1147","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpslake.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/vpslake.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/vpslake.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/vpslake.com\/blog\/wp-json\/wp\/v2\/comments?post=1147"}],"version-history":[{"count":1,"href":"https:\/\/vpslake.com\/blog\/wp-json\/wp\/v2\/posts\/1147\/revisions"}],"predecessor-version":[{"id":4159,"href":"https:\/\/vpslake.com\/blog\/wp-json\/wp\/v2\/posts\/1147\/revisions\/4159"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpslake.com\/blog\/wp-json\/wp\/v2\/media\/1148"}],"wp:attachment":[{"href":"https:\/\/vpslake.com\/blog\/wp-json\/wp\/v2\/media?parent=1147"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/vpslake.com\/blog\/wp-json\/wp\/v2\/categories?post=1147"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/vpslake.com\/blog\/wp-json\/wp\/v2\/tags?post=1147"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}