LinuxmacOSWindows

Where Does Terminus Store Sessions and Settings?

Terminus keeps connections and settings in its config folder under home, with vault secrets in the OS keychain.

Last updated

Terminus stores profiles and app settings in a config folder inside your home directory. Saved SSH connections live there as structured files with hostnames and keys referenced by path. Passwords stay out of them in the system keychain or encrypted vault.

Exact filenames inside have shifted across Terminus releases, so treat the folder as managed and edit through the app. Sync plugins can mirror connections to a gist, which suits multi machine setups better than file copies.

Where Terminus stores this, by platform

Linux
~/.config/Terminus

Connections, settings, and plugin data live here. Passwords stay in the keychain rather than these files. Back up with Terminus closed.

macOS
~/Library/Application Support/Terminus

Same Electron user data layout on Mac. Exact inner filenames vary by Terminus release. Secrets resolve through Keychain entries.

Windows
%APPDATA%\Terminus

Same tree under Roaming. SSH keys referenced by path must exist at the same locations on a new machine. Re link keys after migrating.

Frequently asked questions

How do I move Terminus sessions to a new machine?

Copy the config folder to the same path with Terminus closed, then re enter vault passwords. SSH keys need copying separately to matching paths. Sync plugins automate this going forward.

Where are Terminus passwords?

In the OS keychain or the encrypted vault, never in the session files. Session files hold hostnames and usernames only. The vault password itself is not recoverable.

Notice an outdated path? Let us know.