Skip to content

SeaweedFS SeaweedFS

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

Build Status Last Commit OCI Pulls

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

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
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
      # - S3_BUCKET=  # Comma-separated S3 buckets to pre-create on startup (read natively by weed)
    volumes:
      - "/containers/seaweedfs:/config"
      - "/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.

Warning

Exposing ports in AppJail means that your service can be reached from remote hosts. If that is not your intention, do not expose the ports and communicate with the service using the jail's IPv4 address or hostname assigned by the virtual network.

1
2
3
4
5
6
7
# .env

DIRECTOR_PROJECT=seaweedfs
PUID=1000
PGID=1000
TZ=UTC
SEAWEEDFS_MODE=server

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# appjail-director.yml

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  seaweedfs:
    name: seaweedfs
    options:
      - container: '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}'
    volumes:
      - SEAWEEDFS_CONFIG_PATH: /config
      - SEAWEEDFS_DATA_PATH: /data
volumes:
  SEAWEEDFS_CONFIG_PATH:
    device: '/containers/seaweedfs'
  SEAWEEDFS_DATA_PATH:
    device: '/containers/seaweedfs/data'

1
2
3
4
5
6
7
# Makejail

ARG tag=latest

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

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

Experimental

Bastille's OCI support is experimental. It requires buildah and shares the host network stack (inherit). Mount volumes with --volume HOST JAIL; without it, image-declared volumes are stored under ${bastille_volumesdir}/${jail}.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
services:
  seaweedfs:
    name: seaweedfs
    image: "ghcr.io/daemonless/seaweedfs:latest"
    network:
      - mode: host
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
      - SEAWEEDFS_MODE=server
    volumes:
      - "/containers/seaweedfs:/config"
      - "/containers/seaweedfs/data:/data"

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

Open http://<server>:8333 from another machine (the server's own browser can't use a published port).

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