From b8c5573d01ab159a67ebcd7ff28c772712ed73ba Mon Sep 17 00:00:00 2001 From: Kevin Abramczyk Date: Sun, 15 Nov 2026 15:36:11 -0500 Subject: [PATCH] Ship a systemd service in the deb package. --- .../packaging/debian/postinst.in | 20 ++++++++++++++++ .../libbitcoin-server/packaging/debian/postrm | 15 ++++++++++++ .../libbitcoin-server/packaging/debian/prerm | 3 +++ .../packaging/systemd/bs.cfg | 21 ++++++++++++++++ .../systemd/libbitcoin-server.service | 24 +++++++++++++++++++ .../systemd/libbitcoin-server.sysusers | 1 + .../systemd/libbitcoin-server.tmpfiles | 5 ++++ .../workflows/package-release.yml | 12 ++++++++++ version4.xml | 5 ++++ 9 files changed, 106 insertions(+) create mode 100644 github/version4/libbitcoin-server/packaging/debian/postrm create mode 100644 github/version4/libbitcoin-server/packaging/systemd/bs.cfg create mode 100644 github/version4/libbitcoin-server/packaging/systemd/libbitcoin-server.service create mode 100644 github/version4/libbitcoin-server/packaging/systemd/libbitcoin-server.sysusers create mode 100644 github/version4/libbitcoin-server/packaging/systemd/libbitcoin-server.tmpfiles diff --git a/github/version4/libbitcoin-server/packaging/debian/postinst.in b/github/version4/libbitcoin-server/packaging/debian/postinst.in index 312bc42a..515ea716 100644 --- a/github/version4/libbitcoin-server/packaging/debian/postinst.in +++ b/github/version4/libbitcoin-server/packaging/debian/postinst.in @@ -24,4 +24,24 @@ if [ "$1" = "configure" ]; then ln -sf "${directory}/${variant}" /usr/bin/bs echo "libbitcoin-server: installed ${variant} as /usr/bin/bs." + + # Create the service account and store directory, and load the service + # unit (not enabled). + if command -v systemd-sysusers > /dev/null; then + systemd-sysusers /usr/lib/sysusers.d/libbitcoin-server.conf + fi + + if command -v systemd-tmpfiles > /dev/null; then + systemd-tmpfiles --create /usr/lib/tmpfiles.d/libbitcoin-server.conf || true + fi + + if [ -d /run/systemd/system ]; then + systemctl daemon-reload + fi + + # A 'bs -d true' unit conflicts with the packaged service (only one runs). + if [ -f /etc/systemd/system/bs.service ]; then + echo "libbitcoin-server: found /etc/systemd/system/bs.service (from 'bs -d true')." >&2 + echo "libbitcoin-server: it conflicts with libbitcoin-server.service, run 'bs -d false' to remove it." >&2 + fi fi diff --git a/github/version4/libbitcoin-server/packaging/debian/postrm b/github/version4/libbitcoin-server/packaging/debian/postrm new file mode 100644 index 00000000..c8efa0fa --- /dev/null +++ b/github/version4/libbitcoin-server/packaging/debian/postrm @@ -0,0 +1,15 @@ +#!/bin/sh +set -e + +case "$1" in + remove|purge) + # The service account and /var/lib/libbitcoin-server are retained. + if [ "$1" = "purge" ]; then + rm -f /etc/systemd/system/multi-user.target.wants/libbitcoin-server.service + fi + + if [ -d /run/systemd/system ]; then + systemctl daemon-reload || true + fi + ;; +esac diff --git a/github/version4/libbitcoin-server/packaging/debian/prerm b/github/version4/libbitcoin-server/packaging/debian/prerm index c6ee5bee..34cf8dd9 100644 --- a/github/version4/libbitcoin-server/packaging/debian/prerm +++ b/github/version4/libbitcoin-server/packaging/debian/prerm @@ -3,6 +3,9 @@ set -e case "$1" in remove|deconfigure) + if [ -d /run/systemd/system ]; then + systemctl stop libbitcoin-server.service || true + fi rm -f /usr/bin/bs ;; esac diff --git a/github/version4/libbitcoin-server/packaging/systemd/bs.cfg b/github/version4/libbitcoin-server/packaging/systemd/bs.cfg new file mode 100644 index 00000000..a64710d8 --- /dev/null +++ b/github/version4/libbitcoin-server/packaging/systemd/bs.cfg @@ -0,0 +1,21 @@ +# Libbitcoin Server configuration file +# +# See https://libbitcoin.org/configuration/index.html for all settings, +# common setups, ports and test chain configurations. Run 'bs --settings' +# to display every setting with its description and default. +# +# This file configures the libbitcoin-server service, which runs as the +# libbitcoin user. Start it with 'systemctl enable --now libbitcoin-server'. + +[folders] +root = /var/lib/libbitcoin-server +console = log +events = log + +[admin] +bind = 127.0.0.1:8080 +connections = 10 + +[native] +bind = 127.0.0.1:8180 +connections = 10 diff --git a/github/version4/libbitcoin-server/packaging/systemd/libbitcoin-server.service b/github/version4/libbitcoin-server/packaging/systemd/libbitcoin-server.service new file mode 100644 index 00000000..031b3e90 --- /dev/null +++ b/github/version4/libbitcoin-server/packaging/systemd/libbitcoin-server.service @@ -0,0 +1,24 @@ +[Unit] +Description=Libbitcoin Server +Documentation=https://libbitcoin.org/configuration/index.html +After=network-online.target +Wants=network-online.target +Conflicts=bs.service +After=bs.service + +[Service] +Type=notify +User=libbitcoin +Group=libbitcoin +ExecStart=/usr/bin/bs --config /etc/libbitcoin-server/bs.cfg +StateDirectory=libbitcoin-server +WorkingDirectory=/var/lib/libbitcoin-server +TimeoutStartSec=600 +TimeoutStopSec=600 +NoNewPrivileges=yes +PrivateTmp=yes +ProtectHome=yes +ProtectSystem=full + +[Install] +WantedBy=multi-user.target diff --git a/github/version4/libbitcoin-server/packaging/systemd/libbitcoin-server.sysusers b/github/version4/libbitcoin-server/packaging/systemd/libbitcoin-server.sysusers new file mode 100644 index 00000000..a82262ee --- /dev/null +++ b/github/version4/libbitcoin-server/packaging/systemd/libbitcoin-server.sysusers @@ -0,0 +1 @@ +u libbitcoin - "Libbitcoin Server" /var/lib/libbitcoin-server diff --git a/github/version4/libbitcoin-server/packaging/systemd/libbitcoin-server.tmpfiles b/github/version4/libbitcoin-server/packaging/systemd/libbitcoin-server.tmpfiles new file mode 100644 index 00000000..fd19a562 --- /dev/null +++ b/github/version4/libbitcoin-server/packaging/systemd/libbitcoin-server.tmpfiles @@ -0,0 +1,5 @@ +# On btrfs the store is a subvolume (excluded from root snapshots) without +# copy-on-write (which fragments its memory-mapped tables). Elsewhere it is a +# plain directory and the attribute is ignored. +v /var/lib/libbitcoin-server 0755 libbitcoin libbitcoin - +h /var/lib/libbitcoin-server - - - - +C diff --git a/github/version4/libbitcoin-server/workflows/package-release.yml b/github/version4/libbitcoin-server/workflows/package-release.yml index 161b46e2..543d9e4a 100644 --- a/github/version4/libbitcoin-server/workflows/package-release.yml +++ b/github/version4/libbitcoin-server/workflows/package-release.yml @@ -114,6 +114,17 @@ jobs: install -m 0755 "binaries/${{ matrix.baseline }}" "${LIBRARY}/${{ matrix.baseline }}" install -m 0755 "binaries/${{ matrix.optimized }}" "${LIBRARY}/${{ matrix.optimized }}" + # The service runs /usr/bin/bs, so it survives variant changes. + SYSTEMD="libbitcoin-server/.github/packaging/systemd" + install -D -m 0644 "${SYSTEMD}/bs.cfg" package/etc/libbitcoin-server/bs.cfg + install -D -m 0644 "${SYSTEMD}/libbitcoin-server.service" \ + package/usr/lib/systemd/system/libbitcoin-server.service + install -D -m 0644 "${SYSTEMD}/libbitcoin-server.sysusers" \ + package/usr/lib/sysusers.d/libbitcoin-server.conf + install -D -m 0644 "${SYSTEMD}/libbitcoin-server.tmpfiles" \ + package/usr/lib/tmpfiles.d/libbitcoin-server.conf + echo /etc/libbitcoin-server/bs.cfg > package/DEBIAN/conffiles + sed -e "s|@VERSION@|${VERSION}|" \ -e "s|@ARCHITECTURE@|${{ matrix.architecture }}|" \ -e "s|@INSTALLED_SIZE@|$(du -sk package/usr | cut -f1)|" \ @@ -126,6 +137,7 @@ jobs: "${PACKAGING}/postinst.in" > package/DEBIAN/postinst install -m 0755 "${PACKAGING}/prerm" package/DEBIAN/prerm + install -m 0755 "${PACKAGING}/postrm" package/DEBIAN/postrm chmod 0755 package/DEBIAN/postinst dpkg-deb --root-owner-group --build package \ diff --git a/version4.xml b/version4.xml index ebcab517..4fa9fe6f 100644 --- a/version4.xml +++ b/version4.xml @@ -5001,6 +5001,7 @@ g and optimizations for size." hidden="false" display="*nix/GNU/Release/Static/S + @@ -5030,6 +5031,10 @@ g and optimizations for size." hidden="false" display="*nix/GNU/Release/Static/S + + + +