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