Create Volume

The Create Volume form showing the type tabs, name, host selector and permissions section.

Create a new persistent storage volume on a host. A new volume starts in the Pending state and moves to Created once the agent reconciles it.

Basic information

• Type: choose Volume or Bind with the tab selector.
  • Volume is a Docker-managed named volume.
  • Bind maps a path on the host. Selecting Bind reveals the Path on host field, which is required.
• Name: required.
• Description: optional.
• Host: required. The dropdown is filtered to hosts where you hold the matching create permission. The Volume type needs the volume create permission, and the Bind type needs the bind-mount create permission. If a host is missing, you likely lack that permission on it.
• Path on host: shown only for the Bind type. The existing host path the volume binds to.

The container mount path is not set here. It is chosen when the volume is attached to a workspace.

Permissions

Grant other users access to the volume. Each permission row has three flags:

• Attach: attach the volume to a workspace.
• Modify: edit the volume.
• Delete: remove the volume.

Editing a volume later also requires the matching mount creation permission on its host, not just Modify. See Permissions and access control.

Related Pages

• Volumes
• Volume Details