Skip to content

Volumes

Create, rename, edit, back up, and remove Docker volumes.

Docker volumes hold data that outlives a container, such as databases and uploads.

  1. Open Volumes and click Create Volume.
  2. Enter a name.
  3. Optional: pick a driver or add labels.
  4. Click Create.

Open Volumes in the sidebar. The table shows each volume’s name, driver, and current usage.

Which volumes are in use, and how much data they hold.
Persistent volumes used by the demo web server and cache.Persistent volumes used by the demo web server and cache.

Which volumes are in use, and how much data they hold.

  1. Make sure no container is using the volume.
  2. Open the row’s dropdown and choose rename.
  3. Enter the new name. Arcane copies the data to a volume with that name, then removes the original.
  1. Open the row’s dropdown and click the trash icon.
  2. Confirm.

Volumes used by a container can’t be removed.

The workspace lets you work with a volume’s files while containers keep running.

  1. Open a volume’s Workspace.
  2. Edit, add, or move files (see the table below).
  3. Click Save. Edits are staged locally and applied together.

If a file you edited changed in the volume since you opened it, the save is rejected. Refresh, then reapply your edits.

Editing a file in a volume while its container keeps running.
An HTML file open in the volume workspace editor.An HTML file open in the volume workspace editor.

Editing a file in a volume while its container keeps running.

Action What it does
Open a file Edit any UTF-8 text file in a tab.
New File / New Folder Create files and folders anywhere in the volume.
Upload Files Add files from your computer. Asks before replacing existing ones.
Download Save any file, including binary files, to your computer.
Rename, Move, Delete Reorganize the contents.
Restore a file Restore a single file from an existing volume backup.

Limits:

  • Binary files, symlinks, and special files are read-only in the editor. Binary files can still be uploaded, downloaded, and moved.
  • Files over the maximum size (default 10 MiB) can’t be edited in place.
  • The tree loads a folder’s contents when you open it. A folder with more entries than the entry limit shows only its first entries. The workspace tells you when that happens.
  • Volumes with a custom mount configuration (bind-style driver options) can’t be opened in the workspace.
  • If the container sets a numeric user:, workspace writes use that user and group instead of root.

Set the limits on the Arcane container:

Variable Default
ARCANE_VOLUME_WORKSPACE_MAX_FILE_SIZE_MB 10
ARCANE_VOLUME_WORKSPACE_MAX_ENTRIES 10000

Browsing and downloading need volumes:read. For write actions, see the permission catalog.

Open a volume’s Backups to create or schedule snapshots on local storage or S3, or to restore data.

Arcane creates helper containers for backup, restore, and workspace access.

  • They carry the label com.getarcaneapp.internal.resource=true and are hidden from the Containers list by default. To see them, turn on Show Internal Containers in the container table’s view options.
  • Backups and restores run in short-lived containers using Rustic, the backup tool behind Backups.
  • The workspace helper keeps the volume mounted between operations, so it doesn’t restart each time you browse.
  • Arcane removes the workspace helper after the Volume Helper Idle Timeout (default 10 minutes). Set it to 0 to turn off idle cleanup.