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

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.	Newest FreeBSD packages.

Root Privileges Required

Podman on FreeBSD currently requires root. All commands must be run as root (or via doas/sudo).

Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions.

Deployment

Podman Compose AppJail Director Podman CLI AppJail 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"
    restart: unless-stopped

# .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}

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

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

- 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"

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
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.