Install Ysra on a server or edge device, sign it in with a code, share a folder, and keep it running after you log out.

On this page

Installing on a device puts the same ysra program as on your computer onto another one — an edge box with a GPU and camera, a build server, a lab computer — signs it in with a short code, and shares a folder you can work on from your laptop. Before you start you need SSH access to the device as the user who will run Ysra, and the desktop app on your own computer to approve the sign-in. Can’t install anything there (network gear, an ESXi host, a locked server)? Add it as a machine instead; for what a device can reach, see Devices.

Supported Builds
Linux x64 and arm64 (Jetson, Raspberry Pi)
macOS Yes; no background service

1. Install#

On the device:

curl -fsSL https://ysra.ai/install.sh | sh -s -- --device

It is the same checksum-verified install as on a laptop (see Install the CLI). With --device it also lists what the device is missing and the next steps.

2. Add what Ysra needs to contain commands#

On Linux, every command runs in a contained space: it can write only in the shared folder and has no network unless a step needs a package registry. That needs three programs:

sudo apt install bubblewrap socat ripgrep

Use dnf, pacman or apk with the same names on other systems. ripgrep is in apt from Ubuntu 20.04 and Debian 11; on older systems use the release from github.com/BurntSushi/ripgrep. Without them, Ysra says so and only reads and edits files: it never runs a command it can’t contain.

Check the device at any time with ysra doctor. Each line is one check:

Mark Means
✓ Fine
✗ Needs fixing; the line names the command that fixes it (for commands, exactly what is missing)
· Information, such as not signed in as a device

“Package managers” lists only the ones Ysra may use itself with your OK (for example Homebrew), so none is normal on a typical Ubuntu device.

ysra doctor output on a Linux device

ysra doctor on a fresh Linux device, before it is signed in

3. Sign the device in#

  1. On the device:

    ysra login --device
    

    It shows a code such as ABCD-EFGH, valid for 10 minutes.

  2. On your computer, open the desktop app → Settings → Devices → Approve a device, type the code and choose Find it.

  3. Check the device’s name and system, then choose Approve.

A device’s sign-in is separate from yours: it works on folders on that device and can’t see or change your account, your balance or your other devices.

4. Share a folder#

To Run on the device
Work there now, in your SSH session cd /opt/app && ysra
Start work from your laptop ysra serve --folder /opt/app (repeat --folder to share more)

While ysra serve runs, the folder appears in the desktop app under Settings → Devices.

5. Keep it available after you log out (Linux)#

ysra serve --folder /opt/app --install-service

Ysra shows the exact service file and asks before writing anything.

Property Value
Kind A systemd user service, ~/.config/systemd/user/ysra-serve.service; runs as you, not root
Network Connects out to Ysra only; no port is opened
After you log out Run loginctl enable-linger once
Stop and remove systemctl --user disable --now ysra-serve

On macOS there’s no background service: keep ysra serve running in a terminal.

Update#

ysra --version   # ysra 1.20.0 (build …)
ysra update

ysra update checks the download against its published checksum before replacing itself. A device never updates on its own.

Remove a device#

From How What it does
The device ysra uninstall Removes the device from your account, stops and removes the service, deletes its stored sign-in and removes ysra. Then asks whether to delete ~/.ysra (default: keep; --purge deletes, --keep-data keeps, without asking). Never touches your project folders or ~/.ssh
Anywhere else Desktop app → Settings → Devices → Remove Signs the device out at once, wherever it is

If it doesn’t work#

Symptom What to do
The code expired before you approved it Run ysra login --device again; a code lasts 10 minutes
ysra doctor shows ✗ on commands Install what the line names (usually bubblewrap socat ripgrep)
The folder isn’t in Settings → Devices Check ysra serve --folder … is running on the device
It stops when you log out Use --install-service and loginctl enable-linger (step 5)
YsraDocs