Skip to main content
The sessions store keeps each session’s shell state and the workspace’s own record:
  • Each session’s working directory, variables, functions, mount modes and profile rules. Shell options and the last exit status stay with the running instance.
  • Which sessions the workspace has, and which one is the default.
A workspace built again under the same id finds its sessions where it left them, and every instance of the workspace on the same store shares them. The group key is store.sessions. It is the only store that takes s3, so s3 goes on this key, never on store.type. Set store.type as well. A store block without it keeps the other stores in memory, even on a server: the server keeps them on disk only when the config has no store block. The examples below set type: disk, which matches that default.

On disk

On Redis

In an S3 bucket

The block takes the same fields as an S3 mount, so credentials and an endpoint_url for an S3-compatible store go here too.