Create Shared Storage service

Create Using Zerops GUI

Go to your project dashboard and choose Add new service in the left menu in the Services block. Then add a new Shared Storage service:

Set a Hostname

Enter a unique service identifier like "storage", "files" etc.

• Maximum 25 characters
• Must contain only lowercase ASCII letters (a-z) or numbers (0-9)
• Must be unique within the project

Note

The hostname is fixed after the service is created. It can't be changed later.

Connect to Services

Select one or more of the project's runtime services in the Share with Services block:

Runtime services can be connected and disconnected at any time, even after the shared storage is created.

Choose Deployment Mode

Choose between Highly Available (recommended for production) and Single Container (suitable for development). See the mode comparison and technical details.

Warning

The deployment mode is fixed after the service is created. It can't be changed later.

Set Auto Scaling Configuration

Configure vertical auto scaling parameters to control resource allocation and costs:

Note

Raising the disk limits does not raise the usable data capacity, which is capped at 60GB. See Storage Capacity and Auto Scaling Configuration.

Create Using Import YAML

The deployment mode is part of the service type:

zerops-import.yaml

services:
  - # Shared storage service in highly available mode
    hostname: teststorage
    type: shared-storage:ha

Use shared-storage:single for the single container mode.

Note

You can also pin the underlying engine version directly with seaweedfs:ha@3 or seaweedfs:single@3.

Import the file with the zCLI:

zcli project service-import zerops-import.yaml

To mount the storage into a runtime service in the same import, add the mount: parameter to the runtime service. See the import reference for details and requirements.

Runtime-Specific Guides

Create a runtime service with a Shared storage via import YAML.

Node.jsPHPPythonGo.NETRust