# 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:

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

Build only this package:

```sh
ALPINE_PACKAGE=seaweedfs mise run apk:build
```

Install-test an existing local build without rebuilding:

```sh
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:

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

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

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

Available OpenRC role packages:

```text
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:

```sh
apk del seaweedfs-openrc
apk add seaweedfs seaweedfs-master-openrc
```

## Configure Services

Runtime files are installed in the usual Alpine locations:

```text
/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:

```text
/usr/share/doc/seaweedfs/examples/
```

Enable and start only the services needed on the node:

```sh
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:

```sh
weed version
rc-service seaweedfs.master status
```

## Optional Packages

Install docs and generated examples:

```sh
apk add seaweedfs-doc
```

Install bash completion:

```sh
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:

```sh
apk upgrade seaweedfs
rc-service seaweedfs.master restart
```

Pin a specific package build when needed:

```sh
apk add seaweedfs=4.31-r3
```