Session logs

This page explains how Termius records terminal sessions, where they're stored, and how Bookmarks let you keep important sessions long-term.

Overview

Session logs are a record of your terminal activity. They help you review past work, troubleshoot issues, and collaborate with teammates.

A session log lives in the vault where it was recorded. Local terminal session logs are always stored in your Personal vault and are not synced with your team, so only you can see them.

By default, Termius keeps one recent session log per host. Every time you connect, a new log starts recording automatically and is saved when the session ends, replacing the previous one for that host. To keep a session for future reference, you can bookmark it.

In a Multiplayer session, the log is recorded only for the session owner. The log captures everything as if the session owner were working alone, regardless of who else joins or who is typing at any given moment. Guests who join a Multiplayer session do not have a log recorded on their own account.

Depending on your plan, logs can be synced across devices, shared with teammates, bookmarked for future reference, and kept under different retention policies.

Session logging is supported for local terminal, serial, Telnet, and SSH connections. Mosh sessions are not recorded.

View session logs

The Logs screen lists every log you have access to. You can sort the list by date or by bookmarked logs first, and filter by vault.

Clicking a log opens it as a tab. You can add the log to a Workspace to reference it while you work with other hosts.

Logs can't be viewed on mobile, though iOS and Android still record and sync sessions in the background. To view them, open Termius on macOS, Windows, or Linux.

Save session logs

Bookmarks let you save important session logs in your vault for future reference, for example, troubleshooting steps, incident investigations, configuration changes, or solutions to recurring issues. While recent logs are rotated automatically, bookmarked logs are preserved until you remove the bookmark.

You can also add comments to a bookmarked log to provide some context, such as what you were investigating, why a change was made, or what conclusions were reached during the session.

To bookmark a session log:

1. Open Vault tab→ Logs

   
2. Click Bookmark icon for the required log

   
3. (Optional) Add a comment. Click outside the field or press Enter to save

   

Disable and enable logging

Session logging is enabled by default for all vaults. If you don't want sessions recorded for a particular vault, you can disable logging for that vault. New sessions are not recorded until you turn logging back on.

Disabling logging deletes all logs in the vault, including bookmarked ones.

To disable or enable logging for a vault:

1. Open Settings → Logs

   
2. Select Enable or Disable for the required vault

   

FAQ

Can I delete a specific session log?

No, single session logs can't be deleted manually. You can, however, replace the recent log for a host by starting and closing a new session on it. The new session becomes the recent log, and the previous one is no longer kept.

This only works while the host is still available, once a host is removed, its remaining logs can only be cleared by disabling logging for the vault.

To clear all logs in a vault at once, see Disable and enable logging.

Can I move a session log to another vault?

No, session logs stay in the vault where they were recorded. To start recording into a different vault, move the host there. Its existing logs stay behind, and new sessions in the new vault start a new recording.

Can I export a session log?

There is no export button for a log, but you can copy the log output and paste it into a file manually.

Are passwords and other sensitive data captured in session logs?

Anything that appears in your terminal as plain text is captured. Passwords typed into interactive prompts (where the terminal hides what you type) are not captured.

Are the logs encrypted?

Session logs are protected by the same end-to-end encryption as the rest of your data. For more information, see Encryption overview.

What happens to my logs if I cancel my subscription or downgrade my plan?

• Pro → Starter (or cancel Pro). Your existing logs remain available to read. New sessions are not recorded on Starter. You can clear the old ones by disabling session logging. See Disable and enable logging.
• Team or Business → Pro. Team and Custom vaults are removed, and their logs are deleted along with them. Your logs in the Personal vault remain available to read, and new sessions continue to be recorded to the Personal vault.
• Team or Business → Starter (or cancel Team or Business). Team and Custom vaults are removed, and their logs are deleted along with them. Your existing logs in Personal vault stay and remain available to read. New sessions are not recorded on Starter. You can clear the old ones by disabling session logging. See Disable and enable logging.

Can I set a custom retention policy for a vault?

It depends on your requirements. By default, Termius keeps one recent session log per host. To preserve a specific log you can bookmark it.

• Recent session log is the last session you closed on a host. Each new session you close replaces the previous one.
• Bookmarked session logs are sessions you have saved. They stay in your vault until you remove the bookmark. See Bookmarks.

Сontact us to discuss options.