Alpine Linux notes

The second best Linux distribution.

Published: Mar 17, 2025

General

Run an Alpine Linux instance with Docker

Great for testing purposes. Original reference.

docker run -it --rm alpine /bin/ash

Running PixivFE as an OpenRC service

In this section, we’ll get PixivFE running as an OpenRC service on an Alpine Linux Docker image.

The stock Alpine image does not ship with OpenRC, so in order to create and run OpenRC services in our Alpine instance, we’ll need a workaround:

docker run -it -v /sys/fs/cgroup -p 8282:8282 --rm alpine /bin/ash

You should be greeted with an interactive ash shell. Welcome to Alpine Linux! Now, copy the following code block below and execute it:

cd ~

# Install basic dependencies
apk add --repository https://dl-cdn.alpinelinux.org/alpine/edge/testing \
      git curl go openrc micro

# Clone and build PixivFE
git clone --depth 1 https://codeberg.org/PixivFE/PixivFE/ \
    -b v2                  ## Clone a specific remote branch (e.g: tailwind-rewrite)
cd PixivFE/

## Get TailwindCSS
curl -sLO https://github.com/tailwindlabs/tailwindcss/releases/download/v4.0.14/tailwindcss-linux-x64-musl
chmod +x ./tailwindcss-linux-x64-musl
./tailwindcss-linux-x64-musl -i assets/css/tailwind-style_source.css -o assets/css/tailwind-style.css
./build.sh

mv ./pixivfe /usr/local/bin/

# PixivFE config file (put your own configs here)
mkdir /etc/pixivfe
echo 'token:
- 123456_arstdhnei' > /etc/pixivfe/config.yml

# Setup init script
echo '#!/sbin/openrc-run

name="pixivfe"
command="/usr/local/bin/pixivfe"                  # Path to directory
command_args="-config /etc/pixivfe/config.yml"
directory="/root/PixivFE"                         # Path to PixivFEs source code (yes, it is needed)
command_background=yes
pidfile="/run/$name.pid"
error_log="/var/log/$name.err"

depend() {
        need net
        after firewall
}' > /etc/init.d/pixivfe

chmod a+x /etc/init.d/pixivfe

# Running the service
# https://stackoverflow.com/questions/77188345/alpine-docker-hostname-service-wont-start-sethostname-operation-not-permitte
echo 'rc_need="!dev !net"' >> /etc/rc.conf
openrc
touch /run/openrc/softlevel
rc-service pixivfe restart

# Profit!
curl -sI localhost:8282 | grep -i "X-Powered-By"
# X-Powered-By: hatsune miku

Thanks to the -p 8282:8282 argument we passed into our Docker command earlier, you can access PixivFE directly on your host machine.

Alpine Package Keeper (apk)

Specify a repository to fetch packages from

Edit /etc/apk/repositories to change repositories permanently.

apk add <package-name> --repository https://dl-cdn.alpinelinux.org/alpine/edge/testing/

← Go to parent