Container
Run the official RustFS container image with Docker or Podman.
RustFS is an open-source, S3-compatible distributed object storage system. In single-node single-disk (SNSD) mode, RustFS does not use erasure coding and stores no redundant data, so this mode is suitable only for local testing and small workloads. The official RustFS image packages the RustFS binary and its runtime environment into a container, so you can start RustFS with persistent storage by running a single command.
The container runs as non-root user rustfs with id 10001, so a bind-mounted host directory must be owned by 10001 to avoid permission denied errors.
Container runtimes
- Docker: run a single-node instance with persistent storage, then extend it with Docker Compose, TLS, and multi-node networking.
- Podman: run the same image in a daemonless workflow.
Directory permissions
If you mount a host directory into the container with -v, make sure the owner of the host directory is 10001:
chown -R 10001:10001 /path/to/host_directoryFor Kubernetes deployments, see the Helm chart or the Operator instead.