A self-hosted SSH connection manager. Store hosts, organize them in folders, connect through an in-browser terminal. Credentials are encrypted at rest. Use it solo, or in team mode where several people share one encrypted vault with their own logins and a full audit log.
Open-source. AGPL-3.0. Single binary + SQLite — no cloud, no telemetry.
First-time setup — empty dashboard with import / add host CTAs.
Adding a host. Password or private key auth.
Paste your ~/.ssh/config and Skiff parses it.
I had a text file called servers.md with a growing list of SSH commands I kept copy-pasting into my terminal. Every time I added a new VPS or rotated a key I'd promise myself I'd "set up a proper tool", then I'd open Termius, see the sign-in screen, and close it again. I didn't want my SSH inventory in someone else's cloud — and the desktop alternatives are either paid or feel like they were designed in 2011.
So one weekend I figured how hard could it really be: encrypted SQLite + ssh2 + xterm.js. A couple of weeks later I had something I actually use every day. It's not finished — see "Known issues" for the rough edges — but it scratches the itch.
| Skiff | Termius | Royal TSX | SecureCRT | |
|---|---|---|---|---|
| Self-hosted | yes | no | no | no |
| Open source | yes | no | no | no |
| Price | free | freemium ($) | paid ($45+) | paid ($99+) |
| Encryption at rest | yes | yes | yes | yes |
| In-browser terminal | yes | no (native app) | no | no |
| Mobile access | works on phone | iOS + Android apps | no | no |
| Cloud sync | optional / never | required for sync | local only | local only |
| Telemetry | none | yes | unknown | unknown |
| Docker deploy | one command | n/a | n/a | n/a |
| Team features | yes (self-hosted) | yes (paid) | yes | yes |
Skiff is for people who want to own their SSH inventory. Run it solo, or in team mode where a group shares one encrypted vault — each member with their own login and every action recorded in an audit log, all on your own server. If you need a polished mobile app or enterprise SSO today, Termius and Teleport are still ahead. Skiff is for the case where you specifically don't want your servers' credentials living in someone else's cloud.
- Encrypted credential vault. AES-256-GCM at rest, key derived from your master password with argon2id (OWASP params). The key lives in memory while you're unlocked and gets zeroed on lock or idle timeout. The password itself is never stored — only an HMAC verifier so we can tell you "wrong password" without having to decrypt anything.
- In-browser terminal. xterm.js over a WebSocket. Real SSH session, no fake shell.
- Folders, favorites, search. Search hits labels, hostnames, and usernames.
- Imports your
~/.ssh/config. ParsesHost,HostName,Port,User,IdentityFile. Doesn't handleIncludedirectives yet (see Known issues). - Dark / light themes. Persists in localStorage.
- SSH host fingerprint pinning. First connect saves it; mismatches block the connection.
- Auto-lock on idle. Configurable, defaults to 15 minutes.
- Team mode (optional). Run the vault for a group instead of one person. Multiple user accounts, each with their own login, sharing one encrypted vault. Admins add members, reset passwords, and disable accounts; every privileged action — logins, connections, host changes — is recorded in an audit log. A personal vault can be upgraded to a team vault in place without touching your existing hosts. Fully self-hosted; no cloud, no external identity provider.
- Single docker compose command to deploy. SQLite, so no separate database to run.
By default Skiff is a personal vault: one master password, one user. If you're running it for a group, you can use team mode instead.
In team mode there's still exactly one encrypted vault, but multiple people have their own accounts to unlock it:
- Per-user logins. Each member signs in with a username and their own password. Behind the scenes the vault has a single shared encryption key; each user keeps their own copy of it, sealed with a key derived from their password. Any member can decrypt the shared hosts, but every session is tied to a specific user.
- Admins. Admins can add members, reset a member's password, and disable accounts. The first admin is created at setup (or during the personal → team upgrade). Skiff won't let you disable the last remaining admin.
- Audit log. Logins, failed logins, host connections (who connected to which host, as which SSH user), and host/user changes are all recorded. Admins review it from the Admin panel.
- Forgot-password recovery. Because there's no cloud, a forgotten password can't be auto-recovered — but an admin can issue a new temporary password. No data is lost, because credentials are encrypted with the shared vault key, not any individual's password.
Choose the mode at first-run setup, or upgrade an existing personal vault from Settings → Team. The upgrade keeps all your hosts and credentials exactly as they are — your existing vault key simply becomes the shared key, so nothing is re-encrypted. The upgrade is one-way.
What team mode is not: it's not full role-based access control. Every member can see and connect to every host in the shared vault — there are no per-host or per-folder permissions, and no read-only role. If you need granular RBAC for a larger organization, that's out of scope for the open-source project.
git clone https://github.com/Priyanshu-1622/skiff.git
cd skiff
pnpm install
pnpm devThen http://localhost:5173. First load asks you to set a master password — that's the vault.
Requires Node 20+ and pnpm 9+. On Windows you'll need Visual Studio Build Tools because better-sqlite3 and argon2 are native. There's a note in Troubleshooting about this.
cp .env.example .env
# set SKIFF_COOKIE_SECRET=$(openssl rand -hex 32) in .env
# Create the data directory as your own user BEFORE starting.
# If you skip this, Docker creates it as root and the container
# (which runs as the unprivileged node user) can't write the database.
mkdir -p data
docker compose up -d --buildThen http://localhost:8080. Back up ./data/ — that's where the encrypted vault lives.
skiff/
├── apps/
│ ├── web/ React frontend (Vite)
│ │ ├── src/
│ │ │ ├── components/ Shell (Topbar, Sidebar, AppShell), icons
│ │ │ ├── routes/ unlock, setup, dashboard, terminal, settings, team-login, team-admin
│ │ │ ├── lib/ API client, vault store, theme, ws client
│ │ │ └── styles/ Design tokens + per-screen CSS
│ │ └── vite.config.ts
│ └── api/ Fastify backend
│ ├── src/
│ │ ├── crypto/ AES-256-GCM + argon2id, session store, team-vault (shared-key sealing)
│ │ ├── routes/ auth, hosts, folders, terminal, import, settings, team
│ │ ├── db/ SQLite schema + connection + migrations
│ │ └── lib/ auth middleware, audit log, response helpers, id gen
│ └── server.ts
├── packages/
│ └── shared/ Types shared between web and api
├── docs/ Demo gif + screenshots
├── Dockerfile Multi-stage production build
├── docker-compose.yml One-command production deploy
└── .env.example All configurable env vars
It's a pnpm workspace with two apps and one shared types package. The frontend and backend are decoupled — the web app talks to the API over HTTP + WebSocket, no direct imports between them.
These are real things I've noticed using Skiff. Some are easy fixes I haven't gotten to; some need a redesign.
- Import doesn't handle
Includedirectives. If your~/.ssh/configdoesInclude ~/.ssh/config.d/*, those hosts get skipped silently. I'll fix it when I personally need it — right now my config is one file. - No folder reordering. You can create folders and delete them, but you can't drag to reorder or nest existing ones. Plan the hierarchy before you create them, or be prepared to delete and re-create.
- Restore is fresh-instance only. Settings - Backup downloads an encrypted JSON, and a fresh instance can restore it from the setup screen ("Restore from a backup file"). You can't restore over an existing vault though — you'd have to start from a clean
data/directory. Good enough for moving between machines; not an in-place "undo". - Terminal resize is occasionally laggy. xterm.js sends the new dimensions on resize, but during the resize gesture the output can wrap weirdly for a few frames. Stops looking broken once you let go.
- The
.sqlite-shmand.sqlite-walfiles. SQLite in WAL mode creates two sidecar files next to the main DB. They're normal — do not delete them while Skiff is running. You'll corrupt the database. Ask me how I know. - First-time docker build is slow. Native modules (better-sqlite3, argon2) compile from source the first time, which can take 3-5 minutes on a small VPS. After that it's cached.
If you need any of these, Skiff isn't the right tool yet:
- Role-based access control. Team mode shares one vault — every member can see and connect to every host. No per-host permissions, no read-only role.
- SFTP / file transfers. SSH sessions only.
- Bastion / jump host chains. Direct connections only.
- Mobile-optimized terminal. The dashboard works on phones but the terminal really wants a keyboard.
- LDAP / SAML / SSO. Team mode uses Skiff's own user accounts, not an external identity provider.
Most of these are on the roadmap. Some might never be — if you need a polished enterprise-grade tool today, Termius or Teleport will serve you better.
| Frontend | React 18, TypeScript, Vite, TanStack Router, TanStack Query, Zustand |
| Backend | Node 20, Fastify, ssh2, better-sqlite3 (WAL mode), Zod validation |
| Crypto | Node crypto (AES-256-GCM), argon2 |
| Terminal | xterm.js + FitAddon + WebLinksAddon |
| Styling | Plain CSS with design tokens — no Tailwind, no CSS-in-JS |
Picked better-sqlite3 over the async sqlite drivers because the synchronous API makes transactions and prepared statements way less fiddly — and SQLite is fast enough that the "blocking" concern doesn't actually matter at the scale a self-hosted SSH manager runs at, even with a team sharing it.
Master password → argon2id → 32-byte vault key (in memory only).
Each credential → AES-256-GCM(plaintext, vault key) → SQLite as (nonce, ciphertext).
On unlock, we derive the key from your input, compare its HMAC to the stored verifier, and if they match the key sits in memory until you lock or go idle.
What's encrypted: SSH passwords, private keys, passphrases. What's not: labels, hostnames, ports, usernames, folder names. These aren't secrets — they're metadata.
If you forget your master password your credentials are gone. There's no recovery and there can't be one — that's the whole point. (In team mode, an admin can reset another member's password, because the shared key is recoverable from any admin's session — but if every admin loses their password, the vault is unrecoverable.)
Team mode, briefly: one random shared key encrypts every credential. Each user stores their own copy of that shared key, sealed with a key derived from their password (argon2id). Logging in unseals the shared key into memory for that session. Adding a member seals the shared key to their password; resetting a member re-seals it to a new one. The shared key never touches disk unencrypted. Full details in SECURITY.md.
Full version: SECURITY.md.
.env.example lists everything. The ones you actually need to think about:
| Variable | Default | What it does |
|---|---|---|
SKIFF_COOKIE_SECRET |
random | Set this in production. Signs session cookies. |
SKIFF_PORT |
8080 |
API port |
SKIFF_DB_PATH |
./data/skiff.sqlite |
Where the vault lives |
You need Visual Studio Build Tools with "Desktop development with C++". The standalone Node installer doesn't include them. Grab them from https://aka.ms/vs/17/release/vs_BuildTools.exe, restart your terminal, then pnpm install again.
Set SKIFF_PORT=3000 (or whatever) in .env. The Vite dev server's proxy follows it automatically.
Issues and PRs welcome. If it's a feature, open an issue first — easier to discuss before code than after.
Repo conventions: TypeScript strict mode is on, please don't turn it off. Format with Prettier. Commit messages — I don't care much, just be specific enough that git log --oneline is readable.
AGPL-3.0. You can run it, modify it, host it. If you run a modified version as a service, the modified source has to be available under AGPL too.
Built by Priyanshu. Bug reports and PRs welcome.
