alpine-packages/packaging/alpine/local/seaweedfs/README.md

SeaweedFS Alpine Package

This package repackages the official SeaweedFS 4.31 Linux release tarballs for x86_64 and aarch64. It installs the weed binary, short active config defaults, generated examples, bash completion, and split OpenRC service packages.

Package Commands

Refresh generated config examples and bash completion after changing the SeaweedFS version or generated source flow:

ALPINE_PACKAGE=seaweedfs mise run apk:update-generated
ALPINE_PACKAGE=seaweedfs mise run apk:checksum

Build only this package:

ALPINE_PACKAGE=seaweedfs mise run apk:build

Install-test an existing local build without rebuilding:

ALPINE_PACKAGE=seaweedfs SKIP_BUILD=1 mise run apk:test-install

Install Node Roles

Install the base package plus only the OpenRC role packages needed on that node.

For a single-node test or a compact small deployment:

apk add seaweedfs \
  seaweedfs-master-openrc \
  seaweedfs-volume-openrc \
  seaweedfs-filer-openrc

For separated production nodes, install only the role running there:

apk add seaweedfs seaweedfs-master-openrc
apk add seaweedfs seaweedfs-volume-openrc
apk add seaweedfs seaweedfs-filer-openrc

Available OpenRC role packages:

seaweedfs-master-openrc   -> /etc/init.d/seaweedfs.master
seaweedfs-volume-openrc   -> /etc/init.d/seaweedfs.volume
seaweedfs-filer-openrc    -> /etc/init.d/seaweedfs.filer
seaweedfs-s3-openrc       -> /etc/init.d/seaweedfs.s3
seaweedfs-webdav-openrc   -> /etc/init.d/seaweedfs.webdav
seaweedfs-sftp-openrc     -> /etc/init.d/seaweedfs.sftp
seaweedfs-admin-openrc    -> /etc/init.d/seaweedfs.admin
seaweedfs-worker-openrc   -> /etc/init.d/seaweedfs.worker

The package name is seaweedfs, matching Alpine aports. If a node already has Alpine's old generic OpenRC package installed, remove it before installing a role-specific split:

apk del seaweedfs-openrc
apk add seaweedfs seaweedfs-master-openrc

Configure Services

Runtime files are installed in the usual Alpine locations:

/usr/bin/weed
/etc/seaweedfs/*.toml
/etc/conf.d/seaweedfs.*
/etc/init.d/seaweedfs.*

Edit /etc/conf.d/seaweedfs.<role> for command-line flags and /etc/seaweedfs/*.toml for SeaweedFS config. The packaged defaults are short and production-neutral; full upstream example configs are in:

/usr/share/doc/seaweedfs/examples/

Enable and start only the services needed on the node:

rc-update add seaweedfs.master default
rc-service seaweedfs.master start

rc-update add seaweedfs.volume default
rc-service seaweedfs.volume start

rc-update add seaweedfs.filer default
rc-service seaweedfs.filer start

Check the installed binary and service state:

weed version
rc-service seaweedfs.master status

Optional Packages

Install docs and generated examples:

apk add seaweedfs-doc

Install bash completion:

apk add bash-completion seaweedfs-bash-completion

seaweedfs-bash-completion is also selected automatically when seaweedfs and bash-completion are installed together.

Upgrade Or Pin

Use normal Alpine package operations:

apk upgrade seaweedfs
rc-service seaweedfs.master restart

Pin a specific package build when needed:

apk add seaweedfs=4.31-r3