📘 Linux setup guide

How do I connect Yunoc on Linux?

Install OpenConnect and use your email, full address and connection password from Connection Info with the command below. Press Ctrl + C to disconnect.

Last updated · All platform guides

How do I install OpenConnect and connect from the terminal?

1

Install OpenConnect

For Ubuntu / Debian, open Terminal from the applications menu and run these commands one at a time:
Ubuntu / Debiansudo apt update
Ubuntu / Debiansudo apt install openconnect ca-certificates
OpenConnectopenconnect --version
Review the packages and confirm installation when prompted. sudo asks for your local Linux login password; invisible typing is normal. Other distributions are covered below.
2

Get three items from Connection Info

Sign in to Connection Info and find:
① Email → your website email.
② Address → one line’s complete Linux / openconnect address, retaining port and suffix, with exactly one https:// prefix.
③ Connection password → the password under Connection credentials, not your website login password.
Do not use a subscription link or the desktop Yunoc host-only field.
3

Replace two values and enter your password

Replace the email and complete address with your own values, keep the quotes, then run:
Connectsudo openconnect --protocol=anyconnect --user='YOUR_EMAIL' 'https://COMPLETE_CONNECTION_ADDRESS'
[sudo] password for …: → local Linux password (this prompt may be skipped).
Password: → connection password from the website.
Keep passwords out of commands. Leave the terminal open. Remaining on logs is not necessarily a hang; stop and check details if authentication fails.
4

Open a browser and check access

Keep the connection terminal running. Visit a site you need and a site that normally works. An assigned address or Connected message does not prove working access. Check the IPv4 exit if needed. Smart split (PAC) can send some destinations directly, so one IP-check site cannot describe every route. Use the troubleshooting notes below if needed.
5

Press Ctrl + C when finished

Return to the connection terminal and press Ctrl + C. Wait for the process to exit and the shell prompt to return, then close the window and check normal connectivity. Next time, repeat steps 2–4 without reinstalling. Disconnect before copying another line’s address. Avoid kill -9.
Other systems, desktop menus, background operation and certificates

Fedora uses sudo dnf install openconnect. For other distributions, check repositories, network scripts and root certificates in the full guide. GNOME / NetworkManager users can choose the graphical plugin after checking their environment. Set up background or certificate connections only after foreground access works.

Open the detailed Linux guide → for commands, safe background-process shutdown and certificate instructions.

Cannot connect, or connected but unable to browse?

Authentication failure: check the complete address, connection password, plan and online allowance. Certificate error: check the clock and trust store; do not bypass verification. No access after connecting: inspect the network script, DNS and actual routes. Do not change MTU or disable DTLS blindly.

This guide is for a local Linux computer; keep an online device slot available. SSH, containers and routers need separate setup. It does not configure disconnect protection, and existing IPv6 direct access needs separate checking. Website Global / PAC settings differ from Yunoc local modes; reconnect and check routes after changes.

Guides for other platforms

Not sure which routing mode to use? See Global, PAC and Return compared. Something not working? Go to the Help Center.

One account for your devices

On Windows, macOS and Android, sign in to Yunoc with your website account, sync your lines and connect. For other clients, open "Connection Info" for setup instructions. Contact support if you need help.

Sign In / Register