Skip to content

Volume

Volumes are Docker-managed data storage used to persist container data. Compared to directly mounting host directories, volumes are managed by Docker, making them more secure and portable.

Volume List

Go to Container > Volume tab to view the volume list.

Volume List

The list displays the following information:

  • Name: Volume name
  • Driver: Storage driver
  • Scope: Volume scope
  • Mount Point: Actual storage path of the volume on the host
  • Created Time: Creation time
  • Actions: Delete

Create Volume

  1. Click the Create Volume button
  2. Enter the volume name
  3. Select the driver (only local is supported)
  4. Optionally add Labels and Options (key-value pairs passed to the driver)
  5. Click Submit

Using Volumes

Mount Volume When Creating Container

When creating a container, add volume mounts in the Volume option:

  • volume_name:container_path - Use named volume
  • host_path:container_path - Directly mount host directory

For example:

  • mysql_data:/var/lib/mysql - Mount mysql_data volume to container's /var/lib/mysql
  • /opt/ace/data:/data - Mount host's /opt/ace/data directory to container's /data

Volume vs Bind Mount

FeatureVolumeBind Mount
ManagementDocker managedUser managed
Storage LocationDocker data directoryAny host path
BackupRequires Docker commandsDirectly backup directory
PortabilityHighDepends on host path
Use CasesData that needs persistence like databasesConfiguration files, code directories

Delete Volume

Click the Delete button on a volume row to delete a single volume. You can also check multiple volumes and click the Delete button at the top to delete them in bulk.

Warning

Deleting a volume will permanently delete all data in the volume. This operation cannot be undone!

Note

A volume that is in use by a running container cannot be removed. Stop the containers using it first, then delete the volume.

Clean Volumes

Click Cleanup Volumes to delete all unused volumes and free up disk space. Volumes created by AcePanel itself are preserved.

Note

Please confirm that unused volumes do not contain important data before cleaning.

Data Backup

Volume data is stored in the Docker data directory (usually /var/lib/docker/volumes/). You can backup through the following methods:

  1. Use docker run to create a temporary container that mounts the volume and exports data
  2. Directly backup the Docker data directory (requires stopping Docker service)