Docs/Getting Started/First Connection

First Connection

Establish your first direct SSH tunnel to an Ubuntu, Debian, or Amazon Linux host. Authenticate using encrypted ed25519 keys, standard RSA, or passwords.

Open in App
shipown · preview
Interactive Node
First Connection

A recorded walkthrough for this page has not been made yet.

01.How It Works

Add a server with its public address, SSH port, user, and either a private key file (with a passphrase if it has one) or a password. Test the connection first: a bad credential then fails at setup instead of halfway through a deploy. The key is read by the app's main process only, and never reaches the interface.

Step A
Zero Cloud Relays

Client-side operations encrypted directly between your desktop and target server.

Step B
Credentials stay on your computer

SSH keys, passwords and API keys are held by the desktop app and encrypted with your OS keychain.

02.Key Capabilities

# What Shipown runs on the server, over your own SSH connection
$ pm2 jlist
$ docker ps -a --format '{{json .}}'
[ok] Connected to Ubuntu 24.04 LTS (x86_64)

03.Configuration & Setup

1
Initialize target configurationPick one of your saved servers, or add it with its host, port, user and SSH key.
2
Deploy & MonitorVerify telemetry in real time without polling overhead.