Files
dae/docs/en/tutorials/run-on-alpine.md
2024-12-09 20:28:35 +08:00

77 lines
2.0 KiB
Markdown

# Run on Alpine Linux
**Note:**
1. Alpine Linux 3.18 or newer verison has full eBPF support out-of-box, older version of Alpine Linux need to build kernel by yourself.
2. From version 3.20, Alpine Linux has officially disabled some features dae needed beacuse of Alpine Linux's cross CPU architectures compatibility, so only `linux-virt` can be used to run dae defaultly. For `linux-lts` or `linux-edge`, you should build the kernel by yourself.
3. This tutorial is for Alpine Linux 3.20 and newer.
## Enable Community Repo
Run `setup-apkrepos` command, then you'll get a menu list like this:
```
(f) Find and use fastest mirror
(s) Show mirrorlist
(r) Use random mirror
(e) Edit /etc/apk/repositories with text editor
(c) Community repo enable
(skip) Skip setting up apk repositories
```
Then input `c` to enable community repo.
## Enable CGroups
Enable `cgroups` service:
```sh
rc-update add cgroups boot
```
## Mount bpf
Edit `/etc/init.d/sysfs`:
```sh
vi /etc/init.d/sysfs
```
Add the following to the `mount_misc` section:
```sh
# Setup Kernel Support for bpf file system
if [ -d /sys/fs/bpf ] && ! mountinfo -q /sys/fs/bpf; then
if grep -qs bpf /proc/filesystems; then
ebegin "Mounting eBPF filesystem"
mount -n -t bpf -o ${sysfs_opts} bpffs /sys/fs/bpf
eend $?
fi
fi
```
Be careful that the format of the script `/etc/init.d/sysfs` must be correct, or `sysfs` service will be failed.
## Install dae
Installer: <https://github.com/daeuniverse/dae-installer/>
This installer offered an OpenRC service script of dae, after installation, you should add a config file to `/usr/local/etc/dae/config.dae`, then set its permission to 600 or 640:
```sh
chmod 640 /usr/local/etc/dae/config.dae
```
If your config file is ready to work, then you can start dae service:
```sh
rc-service dae start
```
## Start dae at boot
Use `rc-update` to enable dae service:
```sh
rc-update add dae
```