Ubuntu CLI VPN

A terminal VPN for Ubuntu Desktop and Server.

Free VPN CLI gives Ubuntu users a clean command-line workflow: install with the documented shell command, verify the binary, connect from terminal, inspect JSON status, and troubleshoot with doctor diagnostics.

Install on Ubuntu CLI overview
Ubuntu 22.04+ Server JSON output Doctor
#1 Free VPN
App Store · Play Store · Mac
100M+
Installs worldwide
10+ yrs
Battle-tested VPN core
1,000+
Servers · global exits
Ubuntu install

Install Free VPN CLI on Ubuntu with the documented shell command.

Use the Ubuntu shell installer from the CLI docs. It detects the platform, verifies the download, and registers the background service.

Ubuntu install and verify

Run the installer, confirm the binary is available, inspect status, then connect.

Paste in Terminal
$curl -fsSL https://freevpnapp.org/install.sh | sh
$freevpn version
$freevpn status --json
$freevpn up
Ubuntu support notes
  • The CLI docs list Ubuntu 22.04+ in the Linux platform section.
  • Use this page for Ubuntu Desktop and Ubuntu Server workflows.
  • Use doctor --json when DNS, routes, or service setup look wrong.
  • Do not replace the documented installer with invented package-manager commands.
Runs where your work already lives

A VPN CLI for Ubuntu Desktop and Server.

Keep the page Ubuntu-specific: terminal, Desktop, Server, SSH/headless systems, and scripts. No Windows or macOS install paths here.

Ubuntu terminal

Install, connect, check status, change regions, and troubleshoot from the shell.

Ubuntu Desktop

Use terminal commands first, then add the optional GUI companion if you want a window.

Ubuntu Server and SSH

Run the CLI on server environments that allow VPN tunnels, then verify state before relying on it.

Ubuntu scripts

Use JSON output for cron jobs, deploy checks, smoke tests, and automation.

Two lines and you're connected

Install the Ubuntu CLI path, then connect.

Use the documented shell installer from the main CLI page. After install, verify the binary and start the VPN from the Ubuntu terminal.

Paste in Terminal
$curl -fsSL https://freevpnapp.org/install.sh | sh
$freevpn up

For verification, run freevpn version, freevpn status --json, and freevpn doctor --json if something looks wrong.

How it works

up. status. down.

Three verbs cover most day-to-day VPN work. set-region and doctor cover region selection and troubleshooting.

1 Check where you are · connect
freevpn status · up
user@shell $ freevpn status
VPN : disconnected
region : Fastest (auto)
your IP : 122.179.8.116
location : Bengaluru, India
 
user@shell $ freevpn up
Connected to Fastest (auto)
your IP : 85.195.125.198
location: Frankfurt, Germany
2 Switch region · verify · disconnect
freevpn set-region · status · down
user@shell $ freevpn set-region "US East"
Switched to US East
 
user@shell $ freevpn status
VPN : connected
region : US East
your IP : 23.108.55.113
location : Miami, United States
 
user@shell $ freevpn down
tunnel down · routes restored
Ubuntu workflow

Install, verify, connect, diagnose.

Ubuntu users usually need the shortest reliable path: install, verify, connect, check status, and capture diagnostics if the environment blocks VPN behavior.

Paste in Terminal
$curl -fsSL https://freevpnapp.org/install.sh | sh
$freevpn version
$freevpn status --json
$freevpn up
$freevpn doctor --json
CommandWhy it matters
curl -fsSL https://freevpnapp.org/install.sh | shDocumented Ubuntu install path from the CLI page.
freevpn versionVerify the CLI is available after install.
freevpn status --jsonCheck VPN state in a parseable format.
freevpn upConnect from the Ubuntu terminal.
freevpn doctor --jsonTroubleshoot service, DNS, route, license, or egress issues.
Features

Ubuntu-relevant CLI features.

Ubuntu users need a terminal-first VPN that works for desktop, server, SSH, and scripts.

Terminal-first control

Use freevpn commands directly from the shell instead of relying on screenshots or app windows.

JSON output

Use --json for status, regions, and diagnostics when another tool needs to parse VPN state.

Doctor diagnostics

Run freevpn doctor --json when DNS, route, controller, license, or egress checks need evidence.

Region control

List regions, set a default, connect to a selected exit, and verify the result from the command line.

Background service

The install flow registers the daemon so VPN state is not tied to an open terminal.

Optional GUI companion

Install the desktop companion later if you want a window for status, regions, Ad Block, and billing.

Ad Block

Block ads and trackers before Ubuntu apps load them.

Use DNS-level Ad Block from your Ubuntu environment while the VPN is connected. It helps browsers, command-line tools, apps, and background services use the same blocking rules.

  • Blocks known ad, analytics, and tracker domains across the device.
  • Works at the VPN layer, so it helps outside the browser too.
  • Use stats to inspect what was blocked during the current VPN session.
adblock · Ubuntu
$ freevpn adblock on
Ad Block : On
$ freevpn status
VPN : Connected
Ad Block : On
# update anytime: freevpn adblock update
Optional desktop app

Prefer a window? Use the optional Ubuntu desktop companion.

The CLI remains the primary Ubuntu workflow. On Ubuntu Desktop, the optional companion app gives you a window for status, regions, Ad Block, billing, and update checks while talking to the same daemon as the CLI.

Paste in Terminal
$freevpn gui install
$freevpn gui open
$freevpn gui uninstall

On Ubuntu Server or headless SSH sessions, keep using terminal commands and JSON output.

Agent Skill

Give Ubuntu VPN commands to coding agents.

SKILL.md documents Free VPN CLI commands, JSON output, exit handling, and troubleshooting flows. It helps coding agents use Ubuntu terminal VPN commands without guessing from screenshots or human-only text.

Download SKILL.md CLI overview
Works with Claude Cursor Codex OpenClaw Hermes+ any MCP tool
agent · ubuntu
$ freevpn status --json
$ freevpn regions --json
$ freevpn doctor --json
# structured output for agents, scripts, and CI checks
Built for Ubuntu users

Ubuntu VPN workflows that need terminal control.

Use Free VPN CLI when you want a practical VPN flow for Ubuntu Desktop, Server, scripts, and diagnostics.

Developers and sysadmins

Keep VPN state visible while testing APIs, routes, DNS, and service behavior.

Ubuntu Server users

Use shell commands over SSH where the host allows tunnel and route changes.

Cron and automation

Use status --json and doctor --json around network-sensitive jobs.

Cleaner local traffic

Enable VPN-layer Ad Block for browsers, apps, terminals, and background services.

Pricing

Free forever. Upgrade only if you want it.

Free VPN CLI is genuinely free to use: no signup, no email, no credit card. Ubuntu users can use the free plan for desktop, server, SSH, and script workflows. The paid option removes the continuous connection limit for people who want the VPN running all day. Cancel any time. Prices in USD.

Always free

Free plan — $0 forever

No signup. No card. No expiry. Use it as much as you want.

  • 30-min sessions with a 3-min break in between, on repeat, forever.
  • Same servers, regions and Ad Block as the paid plan.
Install free

Need the VPN running non-stop?

The paid plans below remove the 30-min session limit. Nothing else changes.

Weekly
$7.99/wk

Unlimited time, billed weekly. Cancel in one click from the billing portal.

Get unlimited
Annual
$99/yr

Unlimited time. Save ~58% vs. monthly: one charge a year, nothing else to think about.

Get unlimited
Monthly
$21.99/mo

Unlimited time, billed monthly. Swap plans any time from freevpn manage.

Get unlimited
Payments handled by Stripe Cancel anytime No email required for billing
Practical notes

Ubuntu troubleshooting notes.

Most Ubuntu issues are service, permission, DNS, route, or environment restrictions. Use CLI checks before guessing.

  • If the daemon is unreachable, complete the install/service setup flow and retry freevpn status.
  • On locked-down servers or containers, VPN/tunnel permissions may be restricted.
  • Use doctor --json for evidence before support escalation.
  • Keep install instructions Ubuntu-focused: the main command is the shell installer.
FAQ

VPN for Ubuntu FAQ.

Is Ubuntu 22.04+ supported?
The main CLI page lists Ubuntu 22.04+ in the Linux platform section. Use this page for Ubuntu Desktop and Ubuntu Server workflows.
What is the Ubuntu install command?
Use the documented shell installer: curl -fsSL https://freevpnapp.org/install.sh | sh. This page does not invent an apt package name.
Does Free VPN CLI work on Ubuntu Server?
Yes, for server environments that allow VPN tunnels, route changes, and the required background service. Use freevpn status after connecting and freevpn doctor --json when something looks blocked.
Can I use Free VPN CLI over SSH?
Yes. It is designed for terminal-first workflows, but be careful on remote hosts: verify status after connecting and make sure your SSH access is not disrupted by local network policy.
Does Ubuntu require the desktop app?
No. The CLI is the primary workflow. On Ubuntu Desktop, you can optionally add the companion with freevpn gui install for a window-based view.
How do I check VPN status on Ubuntu?
Run freevpn status for human-readable output or freevpn status --json when scripts, agents, or monitoring need structured output.
How do I troubleshoot Ubuntu tunnel or DNS issues?
Run freevpn doctor --json. Some containers, cloud VMs, or locked-down servers may block VPN/tunnel permissions such as /dev/net/tun.

Use Free VPN CLI on Ubuntu.

Install with the documented shell command, verify with status and doctor, then manage the VPN from your Ubuntu terminal.

Install on Ubuntu Main CLI page