GoTerm
All guides

Keys and security

Only through your VPN

On a server of your own, your workspace runs its own WireGuard VPN. With VPN only on, it answers the devices on it, and nobody else.

Updated

On this page
  1. How it works
  2. Add a device
  3. Set it up on the device
  4. Turn VPN only on
  5. People add their own
  6. Good to know

How it works

Each person’s laptop or phone gets a WireGuard setup of its own. With VPN only on, the workspace doesn’t answer anyone off the VPN at all.

alwayslet inlet inrefusedSomeone opens GoTermbrowser, desktop or phoneVPN onlychecks the addressSam’s laptopon the VPNSam’s phoneon the VPNEveryone elseno answer at all
Sam’s laptop and phone, on the VPN, are let in, each as Sam; anyone else gets no answer at all.
  • A device’s address lets in only its own person.
  • Only GoTerm’s traffic goes through the VPN. The rest of the device’s traffic goes the usual way.
  • It runs on a server of your own: Business, or the dedicated server on Personal and Teams.

Add a device

  1. Open Admin, then Security, and under VPN choose Add device.
  2. Pick the Person, and give a Device name, such as Sam’s laptop.
  3. They’re emailed a link that works once, within 24 hours. A device of your own shows its setup at once.

Set it up on the device

  1. Open the link on the device. GoTerm makes its key, and shows the setup once.
  2. On a phone, scan the code in the WireGuard app. On a computer, install WireGuard, import the file, and turn the tunnel on.
  3. On Linux, take Download for Linux when the page offers it.

Tip: Lost the setup? Ask for a new link: it makes a new key and retires the old one.

Turn VPN only on

  1. Set up a device for everyone who needs in. GoTerm lists who has none before it turns on.
  2. From one of your own devices on the VPN, switch on VPN only under Admin, then Security.
  3. Anyone off the VPN is disconnected within seconds. Their sessions keep running.

Tip: Locked out? Whoever runs the server can turn it off with one command.

1Devices set upfor everyone who needs in2From your deviceon the VPN3VPN only onAdmin, then Security4Off the VPNno answer
Everyone gets a device first; then, from a device of your own on the VPN, VPN only goes on, and anyone off it gets no answer.

People add their own

  1. On one of their devices, with the VPN on, a person opens Vault, then Devices, and chooses Add a device under the VPN.
  2. Its setup shows at once. Up to five devices each.
  3. Admins can turn this off with People on the VPN can add their own devices.
Sam’s laptopon the VPNVault, then DevicesAdd a deviceSam’s phoneits own setup
From Sam’s laptop, on the VPN, Sam adds a phone in the Vault, and its setup shows at once.

Good to know

  • VPN only runs on a server that holds your workspace alone: Business, or the dedicated server on Personal and Teams.
  • While it’s on, the allowed addresses and their email passes aren’t used. They’re kept for when it’s off.
  • With VPN only off and the address list on, a device’s address still lets its own person in.
  • Another person signing in from someone’s device is refused.
  • Removing a device disconnects it within seconds.
  • After a move to another region, VPN only arrives off, and each device gets a link to a new setup. Turn it on again once they’re set up.

Didn’t find your answer?

Write to us, and an engineer who builds GoTerm will reply.

Ask an engineer
  • Getting started

    Try the demo, add your first host and open a terminal.
  • Desktop app

    Install it on Windows, dial from your own computer, or use it free.
  • Hosts and jump hosts

    Quick connect, groups, and private servers through a bastion.
  • Sessions and sharing

    Keep sessions running, come back to them, and share them live.
  • Files

    Move files beside your terminal, or between hosts.
  • Web tabs and tunnels

    Open private pages and forward ports through a host.
  • Snippets

    Save commands once, and run them on one host or ten.
  • Monitors

    Check sites and ports, and get told when they go down.
  • Teams and roles

    People, teams, roles, host groups and each team’s activity.
  • Access and contractors

    Give a host for a few hours, and see what changed after.
  • Audit log and recordings

    Who did what, from where, and what their screen showed.
  • Running a workspace

    Your address and region, colours, settings and moves.
  • The Vault and your keys

    Save, share and replace passwords and private keys.
  • Security and sign-in

    Two-factor, confirmed devices, and how secrets are kept.
  • Allowed addresses

    Open your workspace only from your office or VPN.