Skip to main content
Paseo connects to a daemon running on your rig over SSH. Install the daemon in a reusable Amika snapshot so every rig created from that snapshot is ready for Paseo Desktop. This example installs Paseo 0.9.2 on an Ubuntu AMD64 rig. It runs the daemon as the rig user with a systemd user service and keeps that service running when the user is not signed in.

Add the snapshot files

At the root of your repository, create amika-scripts/paseo-daemon.service:
amika-scripts/paseo-daemon.service
Then create amika-scripts/snapshot-init.sh:
amika-scripts/snapshot-init.sh
Make the script executable and commit both files:
The pinned version and checksum make snapshot builds reproducible. Update both values together when you upgrade Paseo. Find releases on the Paseo releases page.

Build the snapshot

Follow Create a snapshot to create a base rig with repository setup skipped. Connect to the base rig, then run the initialization script from the repository root:
Verify that the service is enabled:
Do not start the daemon in the base rig. Paseo stores a stable host identity in ~/.paseo/server-id. Starting it before capture would copy the same identity into every rig created from the snapshot. Take the snapshot after the service is enabled. Each new rig starts the Paseo daemon automatically on 127.0.0.1:6767 and creates its own host identity on first boot.

Connect Paseo Desktop

Install Paseo Desktop on your computer. Then print the rig’s SSH host:
In Paseo Desktop, click Hosts > Add host > Remote SSH. Paste the ssh:// host printed by the command. Paseo reaches the daemon through SSH, so port 6767 does not need to be exposed publicly. See Paseo connectivity for details about remote SSH connections.