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:latestCreate persistent storage
Create a named volume so object data remains available when you replace the container:
podman volume create rustfs-dataBind-mounting a host directory
The named volume above needs no extra setup. If you bind-mount a host directory instead, keep in mind that the container runs as non-root user rustfs with id 10001. Make the host directory owned by 10001, otherwise you will encounter permission denied errors:
chown -R 10001:10001 /path/to/host_directoryStart 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_ADDRESS=":9000" \
-e RUSTFS_CONSOLE_ADDRESS=":9001" \
-e RUSTFS_CONSOLE_ENABLE=true \
-e RUSTFS_OBS_LOGGER_LEVEL=error \
-e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \
docker.io/rustfs/rustfs:latest \
/dataSet 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/healthThe S3 API is available at http://localhost:9000, and the Console is available at http://localhost:9001.
Next steps
Docker
Run RustFS with Docker: single-node setup, host-directory permissions, Docker Compose, TLS, and multi-node deployment.
Kubernetes Installation (Helm)
Deploy RustFS on Kubernetes with the official Helm chart: standalone or distributed mode, storage sizing, probes, production hardening, and server-pool expansion.