From eef533207076b1bad767db277d3db1f138d3ad69 Mon Sep 17 00:00:00 2001 From: "Scott R. Frost" Date: Fri, 31 Jul 2026 15:10:05 -0400 Subject: [PATCH 1/4] Include Alpine Linux installation steps Add installation instructions for Alpine Linux, including CLI and desktop app setup. --- src/pages/get-started/install/linux.mdx | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/src/pages/get-started/install/linux.mdx b/src/pages/get-started/install/linux.mdx index 9b7e8b613..84e5599c8 100644 --- a/src/pages/get-started/install/linux.mdx +++ b/src/pages/get-started/install/linux.mdx @@ -21,6 +21,7 @@ Minimum releases that satisfy both requirements: | Fedora | 43 and newer | any supported release | | RHEL / AlmaLinux / Rocky | 10 and newer, with [EPEL](https://docs.fedoraproject.org/en-US/epel/getting-started/) | any supported release | | Amazon Linux | not available | 2 and 2023 | +| Alpine Linux | 3.23 and newer | 3.23 and newer | Ubuntu 22.04 (GTK 4.6) and Debian 12 (GTK 4.8) ship WebKitGTK 6.0 but their GTK 4 is below 4.10, so the desktop app is not supported there. RHEL 9 provides neither GTK 4.10 nor WebKitGTK 6.0. @@ -138,6 +139,25 @@ sudo gnome-extensions enable appindicatorsupport@rgcjonas.gmail.com Under X11, you may need to restart GNOME Shell (Alt+F2, r, ⏎) after that. Under Wayland you need to logout and login again. +### Alpine Linux +#### for CLI only +``` +apk add netbird netbird-openrc +netbird service start +netbird up +rc-update add netbird default +``` + +#### for CLI and desktop app +``` +apk add netbird netbird-ui netbird-openrc +netbird service start +netbird up +rc-update add netbird default +``` + +#### update then just work with normal Alpine package management `apk update && apk upgrade` + ### Fedora Silverblue (Atomic) / Universal Blue (rpm-ostree) 1. Create the repository file: From 53e52594433dd64501ec68afba9b5ba0034f6008 Mon Sep 17 00:00:00 2001 From: "Scott R. Frost" Date: Fri, 31 Jul 2026 15:38:42 -0400 Subject: [PATCH 2/4] Revise Alpine instructions I omitted the fact that the community repo had to be enabled in my original commit --- src/pages/get-started/install/linux.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/pages/get-started/install/linux.mdx b/src/pages/get-started/install/linux.mdx index 84e5599c8..9f82e1711 100644 --- a/src/pages/get-started/install/linux.mdx +++ b/src/pages/get-started/install/linux.mdx @@ -139,24 +139,24 @@ sudo gnome-extensions enable appindicatorsupport@rgcjonas.gmail.com Under X11, you may need to restart GNOME Shell (Alt+F2, r, ⏎) after that. Under Wayland you need to logout and login again. -### Alpine Linux -#### for CLI only +### Alpine Linux - Requires community repository to be added to apk configuration +#### For CLI only: (If you wish to use DNS remove `--diable-dns`) ``` apk add netbird netbird-openrc netbird service start -netbird up +netbird up --disable-dns rc-update add netbird default ``` -#### for CLI and desktop app +#### for CLI and desktop app: (If you wish to use DNS remove `--diable-dns`) ``` apk add netbird netbird-ui netbird-openrc netbird service start -netbird up +netbird up --disable-dns rc-update add netbird default ``` -#### update then just work with normal Alpine package management `apk update && apk upgrade` +#### Netbird updates then just work with normal Alpine package management `apk update && apk upgrade` ### Fedora Silverblue (Atomic) / Universal Blue (rpm-ostree) From 5a73877a7d07ddd9f2486ac8a58e5236a5833f9e Mon Sep 17 00:00:00 2001 From: Misha Bragin Date: Sat, 1 Aug 2026 15:58:40 +0200 Subject: [PATCH 3/4] Apply suggestion from @braginini --- src/pages/get-started/install/linux.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/get-started/install/linux.mdx b/src/pages/get-started/install/linux.mdx index 9f82e1711..d1dae3305 100644 --- a/src/pages/get-started/install/linux.mdx +++ b/src/pages/get-started/install/linux.mdx @@ -156,7 +156,7 @@ netbird up --disable-dns rc-update add netbird default ``` -#### Netbird updates then just work with normal Alpine package management `apk update && apk upgrade` +#### NetBird updates then just work with normal Alpine package management `apk update && apk upgrade` ### Fedora Silverblue (Atomic) / Universal Blue (rpm-ostree) From d92ca02573458afb4c9eb95c4817ca687940bd0d Mon Sep 17 00:00:00 2001 From: "Scott R. Frost" Date: Fri, 7 Aug 2026 10:15:03 -0400 Subject: [PATCH 4/4] Changes requested by @TechHutTV Updated installation instructions for Alpine Linux and added commands for starting the NetBird service. --- src/pages/get-started/install/linux.mdx | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/src/pages/get-started/install/linux.mdx b/src/pages/get-started/install/linux.mdx index d1dae3305..7e39ca60b 100644 --- a/src/pages/get-started/install/linux.mdx +++ b/src/pages/get-started/install/linux.mdx @@ -132,7 +132,7 @@ On RHEL, AlmaLinux and Rocky Linux 10, `webkitgtk6.0` comes from EPEL, so enable Amazon Linux 2023 does not provide GTK 4 or WebKitGTK 6.0, so install the CLI only there. The tray icon uses the D-Bus StatusNotifierItem protocol. GNOME does not support it natively, so on GNOME desktops install `gnome-shell-extension-appindicator` and enable it: -``` +```bash sudo dnf install gnome-shell-extension-appindicator sudo gnome-extensions enable appindicatorsupport@rgcjonas.gmail.com ``` @@ -140,19 +140,19 @@ Under X11, you may need to restart GNOME Shell (Alt+F2, r, ⏎) after that. Unde ### Alpine Linux - Requires community repository to be added to apk configuration -#### For CLI only: (If you wish to use DNS remove `--diable-dns`) -``` +#### For CLI only: +```bash apk add netbird netbird-openrc -netbird service start -netbird up --disable-dns +rc-service netbird start +netbird up rc-update add netbird default ``` -#### for CLI and desktop app: (If you wish to use DNS remove `--diable-dns`) -``` +#### for CLI and desktop app: +```bash apk add netbird netbird-ui netbird-openrc -netbird service start -netbird up --disable-dns +rc-service netbird start +netbird up rc-update add netbird default ```