SeaweedFS

Description / name	Input element
Container Registry
Container Configuration Root Path
Timezone
User ID
Group ID
SeaweedFS Host Port
SeaweedFS /config Path
SeaweedFS /data Path

SeaweedFS is a fast distributed storage system for blobs, objects, files, and a data lake, scaling to billions of files. It provides an S3 API, POSIX FUSE mount, WebDAV, and a Filer with cross-cluster active-active replication.


Port	`8333`
Registry	`ghcr.io/daemonless/seaweedfs`
Daemonless	daemonless/seaweedfs
Source	seaweedfs/seaweedfs
Website	seaweedfs.com

Version Tags

Shared (recommended)amd64aarch64

Multi-arch manifests — resolve automatically to the right image for your platform.

Tag	Description	Best For
`latest`	Upstream Binary. Built from official release.	Alternative build.
`pkg`	FreeBSD Quarterly. Uses stable, tested packages.	Production stability.
`pkg-latest`	FreeBSD Latest. Rolling package updates.	Staying current.

Tag	Description	Best For
`latest-amd64`	Upstream Binary. Built from official release.	Alternative build.
`pkg-amd64`	FreeBSD Quarterly. Uses stable, tested packages.	Production stability.
`pkg-latest-amd64`	FreeBSD Latest. Rolling package updates.	Staying current.

Tag	Description	Best For
`latest-aarch64`	Upstream Binary. Built from official release.	Alternative build.
`pkg-aarch64`	FreeBSD Quarterly. Uses stable, tested packages.	Production stability.
`pkg-latest-aarch64`	FreeBSD Latest. Rolling package updates.	Staying current.

Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions, including the security model for host vs. container privileges.

Deployment

Podman AppJail Bastille

Compose CLI Ansible

services:
  seaweedfs:
    image: "ghcr.io/daemonless/seaweedfs:latest"
    container_name: seaweedfs
    environment:
      - PUID=1000  # User ID for the application process
      - PGID=1000  # Group ID for the application process
      - TZ=UTC  # Timezone for the container
      - SEAWEEDFS_MODE=server  # SeaweedFS role: server (default, all-in-one S3+filer+volume), mini (turnkey + Admin UI), master, volume, filer, or s3
      - SEAWEEDFS_VOLUME_SIZE_LIMIT_MB=  # Per-volume file rollover size in MB, not a total quota (server/master only; default 30000 ≈ 30GB)
      - WEED_ARGS=  # Extra arguments appended to the weed command (optional)
      - S3_BUCKET=  # Comma-separated S3 buckets to pre-create on startup (read natively by weed)
    volumes:
      - "/path/to/containers/seaweedfs:/config"
      - "/path/to/containers/seaweedfs/data:/data"
    ports:
      - "8333:8333"
      - "9333:9333"
      - "8888:8888"
    # always (not unless-stopped) so FreeBSD's podman rc.d auto-starts it at boot
    restart: always

Save as compose.yaml, then run podman-compose up -d.

podman run -d --name seaweedfs \
  -p 8333:8333 \
  -p 9333:9333 \
  -p 8888:8888 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=UTC \
  -e SEAWEEDFS_MODE=server \
  -e SEAWEEDFS_VOLUME_SIZE_LIMIT_MB= \
  -e WEED_ARGS= \
  -e S3_BUCKET= \
  -v /path/to/containers/seaweedfs:/config \
  -v /path/to/containers/seaweedfs/data:/data \
  ghcr.io/daemonless/seaweedfs:latest

Save as run.sh, then run sh run.sh.

- name: Deploy seaweedfs
  containers.podman.podman_container:
    name: seaweedfs
    image: "ghcr.io/daemonless/seaweedfs:latest"
    state: started
    restart_policy: always
    env:
      PUID: "1000"
      PGID: "1000"
      TZ: "UTC"
      SEAWEEDFS_MODE: "server"
      SEAWEEDFS_VOLUME_SIZE_LIMIT_MB: ""
      WEED_ARGS: ""
      S3_BUCKET: ""
    ports:
      - "8333:8333"
      - "9333:9333"
      - "8888:8888"
    volumes:
      - "/path/to/containers/seaweedfs:/config"
      - "/path/to/containers/seaweedfs/data:/data"

Save as seaweedfs-deploy.yaml, then run ansible-playbook seaweedfs-deploy.yaml.

Director CLI

# .env

DIRECTOR_PROJECT=seaweedfs
PUID=1000
PGID=1000
TZ=UTC
SEAWEEDFS_MODE=server
SEAWEEDFS_VOLUME_SIZE_LIMIT_MB=
WEED_ARGS=
S3_BUCKET=

# appjail-director.yml

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  seaweedfs:
    name: seaweedfs
    options:
      - container: 'boot args:--pull'
      - expose: '8333:8333 proto:tcp'
      - expose: '9333:9333 proto:tcp'
      - expose: '8888:8888 proto:tcp'
    oci:
      user: root
      environment:
        - PUID: !ENV '${PUID}'
        - PGID: !ENV '${PGID}'
        - TZ: !ENV '${TZ}'
        - SEAWEEDFS_MODE: !ENV '${SEAWEEDFS_MODE}'
        - SEAWEEDFS_VOLUME_SIZE_LIMIT_MB: !ENV '${SEAWEEDFS_VOLUME_SIZE_LIMIT_MB}'
        - WEED_ARGS: !ENV '${WEED_ARGS}'
        - S3_BUCKET: !ENV '${S3_BUCKET}'
    volumes:
      - SEAWEEDFS_CONFIG_PATH: /config
      - SEAWEEDFS_DATA_PATH: /data
volumes:
  SEAWEEDFS_CONFIG_PATH:
    device: '/path/to/containers/seaweedfs'
  SEAWEEDFS_DATA_PATH:
    device: '/path/to/containers/seaweedfs/data'

# Makejail

ARG tag=latest

OPTION overwrite=force
OPTION from=ghcr.io/daemonless/seaweedfs:${tag}

Save the files above, then run appjail-director up.

appjail oci run -Pd \
  -o overwrite=force \
  -o container="args:--pull" \
  -o virtualnet=":<random> default" \
  -o nat \
  -o expose="8333:8333 proto:tcp" \
  -o expose="9333:9333 proto:tcp" \
  -o expose="8888:8888 proto:tcp" \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=UTC \
  -e SEAWEEDFS_MODE=server \
  -e SEAWEEDFS_VOLUME_SIZE_LIMIT_MB= \
  -e WEED_ARGS= \
  -e S3_BUCKET= \
  -o fstab="/path/to/containers/seaweedfs /config <pseudofs>" \
  -o fstab="/path/to/containers/seaweedfs/data /data <pseudofs>" \
  ghcr.io/daemonless/seaweedfs:latest seaweedfs

Save as run.sh, then run sh run.sh.

Experimental

Bastille's OCI support is experimental. It requires buildah, shares the host network stack (inherit), and persists image-declared volumes under --data-path.

Compose CLI

services:
  seaweedfs:
    image: "ghcr.io/daemonless/seaweedfs:latest"
    container_name: seaweedfs
    network_mode: host  # jail shares host networking
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
      - SEAWEEDFS_MODE=server
      - SEAWEEDFS_VOLUME_SIZE_LIMIT_MB=
      - WEED_ARGS=
      - S3_BUCKET=

Save as podman-compose.yml, then run bastille up.

bastille create -O \
  --env PUID=1000 \
  --env PGID=1000 \
  --env TZ=UTC \
  --env SEAWEEDFS_MODE=server \
  --env SEAWEEDFS_VOLUME_SIZE_LIMIT_MB= \
  --env WEED_ARGS= \
  --env S3_BUCKET= \
  --data-path /path/to/containers/seaweedfs \
  seaweedfs ghcr.io/daemonless/seaweedfs:latest inherit

Access at: http://localhost:8333

Interactive Configuration

Parameters

Environment Variables

Variable	Default	Description
`PUID`	`1000`	User ID for the application process
`PGID`	`1000`	Group ID for the application process
`TZ`	`UTC`	Timezone for the container
`SEAWEEDFS_MODE`	`server`	SeaweedFS role: server (default, all-in-one S3+filer+volume), mini (turnkey + Admin UI), master, volume, filer, or s3
`SEAWEEDFS_VOLUME_SIZE_LIMIT_MB`	``	Per-volume file rollover size in MB, not a total quota (server/master only; default 30000 ≈ 30GB)
`WEED_ARGS`	``	Extra arguments appended to the weed command (optional)
`S3_BUCKET`	``	Comma-separated S3 buckets to pre-create on startup (read natively by weed)

Volumes

Path	Description
`/config`	TOML config files (filer.toml, security.toml) + s3.json identities
`/data`	Object / volume storage data

Ports

Port	Protocol	Description
`8333`	TCP	S3 API
`9333`	TCP	Master UI / API
`8888`	TCP	Filer UI / API

Implementation Details

Architectures: amd64, aarch64
User: bsd (UID/GID set via PUID/PGID). Defaults to 1000:1000.
Base: Built on ghcr.io/daemonless/base (FreeBSD 15.1).

Need help? Join our Discord community.