sendnrw/netbird-docs
2
0
Fork 0
mirror of https://github.com/netbirdio/docs.git synced 2026-08-26 17:51:27 +02:00
Code Issues Packages Projects Releases Wiki Activity

Include Alpine Linux installation steps (#897)

Browse Source 
* Include Alpine Linux installation steps

Add installation instructions for Alpine Linux, including CLI and desktop app setup.

* Revise Alpine instructions

I omitted the fact that the community repo had to be enabled in my original commit

* Apply suggestion from @braginini

* Changes requested by @TechHutTV

Updated installation instructions for Alpine Linux and added commands for starting the NetBird service.

---------

Co-authored-by: Misha Bragin <bangvalo@gmail.com>
This commit is contained in:
Scott R. Frost
2026-08-14 19:08:12 -04:00
committed by GitHub
parent f5dacdd2fb
commit 02818d13d9
1 changed files with 21 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
src/pages/get-started/install/linux.mdx
View File

@@ -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.
@@ -131,13 +132,32 @@ 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
```
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 - Requires community repository to be added to apk configuration
#### For CLI only:
```bash
apk add netbird netbird-openrc
rc-service netbird start
netbird up
rc-update add netbird default
```
#### for CLI and desktop app:
```bash
apk add netbird netbird-ui netbird-openrc
rc-service netbird start
netbird up
rc-update add netbird default
```
#### NetBird updates then just work with normal Alpine package management `apk update && apk upgrade`
### Fedora Silverblue (Atomic) / Universal Blue (rpm-ostree)
1. Create the repository file: