Docker
Run a single-node RustFS instance with Docker and persistent container storage.
Use the official RustFS image to start a single-node instance with persistent storage. You need a working Docker Engine and permission to run containers.
Pull the image
docker pull rustfs/rustfs:latestCreate persistent storage
Create a named volume so object data remains available when you replace the container:
docker volume create rustfs-dataStart RustFS
Replace the credential placeholders before running the container:
docker run -d \
--name rustfs \
--restart unless-stopped \
-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 \
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:
docker 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.