Docker installation

The Docker image is the most versatile way to run the Blixt server. It works on any platform with Docker installed and exposes NFS and SMB by default.

Before you install

Configure at least one bucket and make sure your credentials are working. See the documentation from your cloud provider for details. Here's our quick starter guide.

If mounting with NFS or SMB, make sure the client software is installed:

macOS — NFS and SMB are installed by default.
Linux — install NFS tools (nfs-common) or SMB tools (cifs-utils).
Windows — SMB is available by default. For NFS, enable the NFS client in Windows Features.

Install Docker and download image

Install Docker.
Pull the latest image from Docker Hub. Our images support both Intel and ARM architectures.
```
docker pull blixtfs/standard:latest
```

Configure your setup

Fill in the fields below and the commands will update automatically.

Data directory Local path for cached metadata, data, and logs. Must be outside the Docker filesystem. For production, use a separate disk. Bucket(s) One or more buckets, space-separated.

s3:// — AWS S3
gs:// — Google Cloud Storage
azure:// — Azure Blob Storage
oci:// — Oracle Object Storage
minio:// — MinIO

Credentials file (optional) Path to a credentials file on your host. Leave empty if using environment variables, GCE/GKE default credentials, or gcloud application default credentials. See our guide for details.

Run the container

docker run -d --name blixt \
  -p 2049:2049 \
  -v /tmp/data:/data \
  blixtfs/standard:latest s3://my-bucket

Mount the share

Mount the share from any client using NFS.

macOS — use the noresvport option for user-initiated mounts:

mount -t nfs -o vers=4,noresvport localhost:/ MOUNT_POINT

Linux:

mount -t nfs -o vers=4 localhost:/ MOUNT_POINT