Skip to content

Servers

Vyre on a server, no desktop needed

vyre-host runs as a service on a Linux or Windows machine. Its terminals show up on the web and on Android like any other Vyre computer, end-to-end encrypted.

curl -fsSL https://updates.vyre.kaxlin.com/vyre-host/install.sh | sudo sh

Install

One command, then approve it in your browser

The machine never sees your password. You approve it from a browser where you are already signed in, and it receives its key encrypted to itself, so Vyre’s servers never see that key either.

1

Run the installer

It picks the build for your CPU, checks its SHA-256, copies it to /opt/vyre-host and sets up a systemd service.

2

Enter the code

It prints a code like ABCD-EFGH. Open vyre.kaxlin.com/pair, sign in, and enter it.

3

Check and approve

The page shows the machine’s name, IP address and a key fingerprint. Approve only if the fingerprint matches the one in your terminal.

4

Open a tab

The service starts and the machine shows up as “name (headless)” on the web and on Android. New Tab lists the shells installed on it.

Whose shell is it?

Every tab runs as the user you choose

The service runs as the account that ran sudo, so a tab opened from your phone can do what that account can do, and nothing more. It refuses to run as root unless you pass --allow-root. To pick another account:

curl -fsSL https://updates.vyre.kaxlin.com/vyre-host/install.sh | sudo sh -s -- --user deploy

Day to day

Managing it

sudo vyre-host statusVersion, pairing and whether the service is installed.
journalctl -u vyre-host -fThe service log. It also says when a newer version is out.
curl -fsSL https://updates.vyre.kaxlin.com/vyre-host/install.sh | sudo shUpdate: run the installer again. Your pairing is kept.
sudo vyre-host unpairRemove this computer from your Vyre account and forget its key.
sudo vyre-host uninstallStop and remove the service. Add --purge to delete its key and settings too.

Requirements

What it runs on

  • Linux with systemd (tested on Ubuntu)
  • A 64-bit x86_64 or arm64 CPU
  • glibc, so not Alpine or other musl-based systems
  • Outbound HTTPS only. Nothing listens for connections, so there is no port to open

Windows

On Windows, as a service

For a Windows PC you sit at, use the Vyre app. For one nobody logs in to, vyre-host runs as a Windows service. Open PowerShell with Run as administrator and run:

irm https://updates.vyre.kaxlin.com/vyre-host/install.ps1 | iex

It asks for your Windows password, because a service needs it to run as you. Tabs are shells running as your account, never as SYSTEM. Windows keeps the password and Vyre does not. If you sign in with a PIN or Windows Hello, use the account’s password, not the PIN. For a Microsoft account that is the password you use on account.microsoft.com, where you can reset it. Then approve the code as above. To update, run the same command again; your pairing is kept. To remove it, run & "C:\Program Files\Vyre\host\vyre-host.exe" uninstall.

Rather not pipe a script into PowerShell? Download the zip, extract it, and run .\vyre-host.exe install in that folder from an administrator terminal.

vyre-host for Windows (x64, .zip)