Podman

Run a single-node RustFS instance with Podman and persistent container storage.

Podman can run the official RustFS Open Container Initiative (OCI) image without a daemon. You need a working Podman installation and permission to create containers.

Pull the image

podman pull docker.io/rustfs/rustfs:latest

Create persistent storage

Create a named volume so object data remains available when you replace the container:

podman volume create rustfs-data

Start RustFS

Replace the credential placeholders before running the container:

podman run -d \
  --name rustfs \
  -p 9000:9000 \
  -p 9001:9001 \
  -v rustfs-data:/data \
  -e RUSTFS_ACCESS_KEY="<your-access-key>" \
  -e RUSTFS_SECRET_KEY="<your-secret-key>" \
  -e RUSTFS_CONSOLE_ENABLE=true \
  docker.io/rustfs/rustfs:latest \
  /data

Set credentials when creating the container

Set unique RUSTFS_ACCESS_KEY and RUSTFS_SECRET_KEY environment variables before exposing RustFS to a network. Do not use the well-known rustfsadmin value for either credential. If the container was started without custom credentials, stop and recreate it with both -e options shown above; the rustfs-data volume remains intact.

Verify the deployment

Check the container and the S3 API health endpoint:

podman ps --filter name=rustfs
curl --fail http://localhost:9000/health

The S3 API is available at http://localhost:9000, and the Console is available at http://localhost:9001.

Next steps

On this page