SSH OS

Website & downloads · macOS & Windows

A macOS-style desktop for managing your servers. Native app for macOS and Windows built with Tauri: about a 6 MB download. It started as a rewrite of cube-ssh.

Features

• Multiple servers — save as many as you like, connect to several at once, switch from the menu bar, Finder sidebar, Dock or Spotlight. Import hosts from ~/.ssh/config.
• SSH, SFTP, FTP, FTPS — password, key file (with passphrase) or ssh-agent auth. Passwords are encrypted with the macOS Keychain (safeStorage). SSH host keys are pinned on first connect, and a changed key blocks the connection.
• Finder — icon, list and column views. Sidebar favorites, back/forward, path bar and search. Drag and drop from macOS to upload, drag between folders or servers to move or copy, and copy/cut/paste across servers. Rename, duplicate, compress and extract, Get Info with chmod, Quick Look (space), "Open with Mac App", download, marquee selection and type-to-select.
• Terminal — xterm.js with tabs (each tab can be a different server), themes and clickable links.
• Code Editor — CodeMirror 6 with syntax highlighting for ~20 languages, tabs, ⌘S, and unsaved-changes guards.
• Activity Monitor — live CPU, memory and network graphs, a process list with quit or force quit, disks, and systemd services (start, stop, restart, logs).
• Console — journal, kernel, syslog, auth, nginx and custom log files, with live streaming and a filter.
• Network Utility — interface info, ping, traceroute, port scan, DNS lookup and HTTP timing, all run from the server.
• Shortcuts — one-click saved commands, either global or per server; run inline or in a Terminal.
• System Settings — light/dark/auto appearance, accent color, wallpapers, Dock size and magnification, terminal font and theme.
• Connect at startup: mark servers to connect automatically when SSH OS opens (in the server's settings or its right-click menu).

Develop

Needs Node 20+ and Rust (stable).

npm install
npm run dev          # Tauri dev app with hot reload
npm run typecheck
npm run build        # release app + installers in src-tauri/target/release/bundle

Architecture

• src/renderer: the React UI (desktop, window manager, Dock, menu bar, Spotlight, all apps).
• src/renderer/src/tauri-bridge.ts: window.api on top of Tauri IPC/events. It also handles native file drops and window controls.
• src-tauri/src: the Rust backend.
  • remote.rs: SSH via russh, SFTP via russh-sftp, FTP/FTPS via suppaftp, plus exec, streams and terminals.
  • transfers.rs: uploads, downloads and copies between servers.
  • store.rs: settings and servers. Passwords live in the OS keychain.
  • ipc.rs: the IPC dispatcher.
  • updater.rs: self-updater (GitHub releases + SHA-256 verification).
  • lib.rs: menu and window setup.

Minecraft Servers app

When SSH OS finds a Minecraft Java server on a connected machine, a Minecraft Servers app appears in the Dock. It looks for any server.properties up to 4 levels deep under ~, /opt, /srv, /home, /var/games, /mnt and /data. You can set it to always show in System Settings → Desktop & Dock.

This is the beginning of the README. Read the rest at the original. Read the full README ↗