For AI agents: the complete documentation index is available at https://www.jumpserver.com/docs/llms.txt, the full documentation bundle is available at https://www.jumpserver.com/docs/llms-full.txt, and this page is available as Markdown at https://www.jumpserver.com/docs/features/system-settings/infrastructure/storage.md.
๐ŸŽ‰ JumpServer v5.1.1 is available. See what's new โ†’

Storage

Storage tells JumpServer where to keep session evidence. Recordings and replay files belong in object storage, and command records belong in command storage. Keeping this data outside the local disk makes it possible to centralize, retain, and scale audit evidence.

Overview

The page has two tabs:

TabStores
Object storageSession recordings and replay files for each component.
Command storageSession command records generated during asset connections.

The table on each tab lists the configured storages with their name, type, description, default marker, and actions. A default entry is preselected for components that register later.

Figure 1: Storage settings

Create storage

1

In the right area of the top navigation bar, click .

image
2

In the left menu, click Storage.

3

Open Object storage or Command storage.

4

Click Create and select the storage type.

5

Enter the connection details for that type and, if appropriate, mark the entry as default.

6

Click Submit.

Supported types

Object storage:

TypeNotes
LocalStores recordings on the JumpServer server.
NullDiscards recordings.
Amazon S3, Ceph, Swift, Alibaba Cloud OSS, Azure Blob, Huawei Cloud OBS, Tencent Cloud COSExternal object storage. Connection fields depend on the provider.
SFTPBackup-only storage, for example for account backups. Cannot be set as the default object storage.

Command storage:

TypeNotes
LocalStores command logs in the local database.
NullDiscards command logs.
ElasticsearchExternal search cluster; requires the host list and index name.

Manage storage entries

  • Set as default: use the more actions menu on an entry. Newly registered components pick up the default automatically; components that are already registered keep their current storage until you change them on the Components page.
  • Test: validates the connection and credentials without connecting a component.
  • Edit: change connection details or the description.
  • Delete: remove the entry. A storage that is still in use by a component should be replaced before deletion.

Notes

Note

The default storage is applied to newly registered components only. SFTP object storage requires an Enterprise license, and it can be used for backups but not as the default recording storage.

Warning

Session recordings and command logs that are written to external storage are not removed by the retention settings in System Tasks; plan retention for the external system separately.