> For the complete documentation index, see [llms.txt](https://docs.termius.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.termius.com/organize-and-connect-to-hosts/session-logs.md).

# Session logs

## Overview

<figure><img src="/files/LIg2VQP21Gja4RroFE9u" alt=""><figcaption></figcaption></figure>

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](#save-session-logs) 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.

{% hint style="warning" %}
Session logging is supported for **local terminal**, **serial**, **Telnet**, and **SSH** connections. **Mosh** sessions are not recorded.
{% endhint %}

## 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.

<figure><img src="/files/9bagResr6mGlRvp9cfe2" alt=""><figcaption></figcaption></figure>

Clicking a log opens it as a tab. You can add the log to a [Workspace](/terminal/workspaces.md) to reference it while you work with other hosts.

<figure><img src="/files/gSdhobNRT1DYFnAfKstx" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**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.
{% endhint %}

## Save session logs

<figure><img src="/files/LIg2VQP21Gja4RroFE9u" alt=""><figcaption></figcaption></figure>

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`&#x20;

   <figure><img src="/files/mKjkoZItB7akvenGLXfu" alt=""><figcaption></figcaption></figure>
2. Click `Bookmark` icon for the required log

   <figure><img src="/files/YjTWTK9WeFChu4oTJlQk" alt=""><figcaption></figcaption></figure>
3. (Optional) Add a comment. Click outside the field or press `Enter` to save

   <figure><img src="/files/grJ0mo4CWxsydylX6b6k" alt=""><figcaption></figcaption></figure>

## 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.

{% hint style="danger" %}
Disabling logging deletes all logs in the vault, including bookmarked ones.
{% endhint %}

#### To disable or enable logging for a vault:

1. Open `Settings` → `Logs`

   <figure><img src="/files/zXc2aH7cz8H98nEIRlvl" alt=""><figcaption></figcaption></figure>
2. Select `Enable` or `Disable` for the required vault

   <figure><img src="/files/qyGiBQdJBhq1yNie2Nx8" alt=""><figcaption></figcaption></figure>

## FAQ

<details>

<summary>Can I delete a specific session log?</summary>

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](#disable-and-enable-logging).

</details>

<details>

<summary>Can I move a session log to another vault?</summary>

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.

</details>

<details>

<summary>Can I export a session log?</summary>

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

</details>

<details>

<summary>Are passwords and other sensitive data captured in session logs?</summary>

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.

</details>

<details>

<summary>Are the logs encrypted?</summary>

Session logs are protected by the same end-to-end encryption as the rest of your data. For more information, see [Encryption overview.](/security/encryption-overview.md)

</details>

<details>

<summary>What happens to my logs if I cancel my subscription or downgrade my plan?</summary>

* **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](#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](#disable-and-enable-logging).

</details>

<details>

<summary>Can I set a custom retention policy for a vault?</summary>

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](#bookmarks-for-session-logs).

&#x20;[Сontact us](https://support.termius.com/hc/en-us/requests/new) to discuss options.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.termius.com/organize-and-connect-to-hosts/session-logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.