Documentation

Everything you need to know about jSSH, from installation to advanced vault security.

Documentation

Everything you need to know to secure your remote servers and use jSSH effectively.

1. The Encrypted Vault

On your first launch, jSSH requires you to create a Master Password. This password serves as the root key to your local SQLite database. We use AES-256-GCM to encrypt all sensitive fields (host passwords, SSH key passphrases, sudo passwords) before they ever touch the disk.

Because your vault is completely local, we do not sync your data to any cloud service. Your passwords are truly yours.

Warning Because your vault is completely offline, there is no "Forgot Password" functionality. If you lose your Master Password, your vault cannot be recovered.

2. Auto-Password Filling

jSSH has a built-in prompt detection engine. When you connect to a server, jSSH monitors the terminal output for standard password: or passphrase for key: prompts.

When a prompt is detected, the terminal will instantly retrieve the correct secret from your unlocked vault and securely inject it into the session. This means you never have to manually type or copy/paste passwords into the terminal.

3. Identities & Workspaces

Use Identities to reuse the same credentials across multiple hosts (e.g., your standard ubuntu key pair). Use Workspaces to organize different clients or projects into separate sidebars.

  • Navigate to the top Identities tab to create a global credential.
  • When creating a new Host, select the Identity from the dropdown instead of typing a password.
  • You can assign hosts to Folders for easy categorization.

4. Built-in SFTP

The SFTP panel allows you to manage files on the remote server seamlessly alongside your local files. To use it, simply click the SFTP button in the top navigation bar.

You can connect to your saved hosts directly from the SFTP interface, and easily drag and drop files between your computer and the server. You can also multi-select files for batch uploads and downloads.

5. Themes & Customization

jSSH is highly customizable. You can change both the App Theme (which affects the UI) and the Terminal Theme (which affects the shell colors).

Navigate to Settings at the bottom of the sidebar to:

  • Change themes to Dracula, Nord, Claude, Light, or Dark.
  • Adjust the terminal font size and font family.
  • Configure auto-lock duration for your vault.
  • Enable/disable features like Snippets or SFTP.

6. Snippets Library

Save frequently used commands in the Snippets library for quick access. You can bind specific snippets to easily copy them or execute them directly in your active terminal sessions, saving you time from repetitive typing.

7. Discord Rich Presence

Show off your developer setup! jSSH features native Discord Game Activity integration. When enabled, your Discord status will show that you are using the jSSH Terminal, complete with direct links to our website and Discord community.