netbird/docs
0
0
Fork 0
mirror of https://github.com/netbirdio/docs.git synced 2026-05-22 17:07:57 -07:00
Code Issues Packages Projects Releases Wiki Activity

Added Homebrew for Linux as instructions for atomic, updated DistroBox docs. (#756)

Browse Source 
* Update Linux installation instructions for NetBird on Fedora Silverblue and Universal Blue. Added Homebrew and Distrobox installation methods, including necessary commands and SELinux configuration notes. Updated Distrobox container image version from Debian 12 to 13.

* Some adjustments to homebrew docs

* removed leading space on the \``bash` opening fence

---------

Co-authored-by: TechHutTV <brandon@techhut.tv>
This commit is contained in:
PizzaLovingNerd
2026-05-19 14:20:53 -07:00
committed by GitHub
parent 8ab98eff17
commit 4e1f5669c9
1 changed files with 66 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/pages/get-started/install/linux.mdx
+66 -5
View File
@@ -14,7 +14,7 @@ curl -fsSL https://pkgs.netbird.io/install.sh | sh
### Ubuntu/Debian (APT)
1. Add the repository:
```bash
```bash
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg -y
curl -sSL https://pkgs.netbird.io/debian/public.key | sudo gpg --dearmor --output /usr/share/keyrings/netbird-archive-keyring.gpg
@@ -92,7 +92,7 @@ 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.
### Universal Blue (Native package)
### Fedora Silverblue (Atomic) / Universal Blue (rpm-ostree)
1. Create the repository file:
```bash
@@ -120,18 +120,79 @@ EOF
systemctl enable --now netbird
```
### Fedora Silverblue / Universal Blue / SteamOS / Immutable Distros (Homebrew)
<Note>
Requires installation of [Homebrew](https://docs.brew.sh/Homebrew-on-Linux), Universal Blue images should have Homebrew preinstalled.
This method does not install the NetBird GUI. It installs the CLI only.
</Note>
1. If NetBird was previously installed with Homebrew, you will need to run:
```bash
# Stop and uninstall daemon service:
sudo netbird service stop
sudo netbird service uninstall
# unlink the app
brew unlink netbird
```
NetBird will copy any existing configuration from the NetBird's default configuration paths to the new default location.
2. Install Netbird
```bash
brew install netbirdio/tap/netbird
```
<Note>
If it gives you an error saying to install Clang, you can install it with
```bash
brew install llvm
```
If that still doesn't work after that, try restarting your terminal to update the path.
</Note>
3. Install and start the client daemon service:
```bash
sudo /home/linuxbrew/.linuxbrew/bin/netbird service install
sudo /home/linuxbrew/.linuxbrew/bin/netbird service start
```
You may need to adjust this command if you are not using the default `/home/linuxbrew/.linuxbrew` prefix for your Homebrew install.
<Note>
On Fedora-based systems including Universal Blue, SELinux may block NetBird from running due to homebrew installing it in ~/linuxbrew.
You can fix this by running
```bash
sudo semanage fcontext -a -t bin_t \
'/home/linuxbrew/\.linuxbrew/Cellar/netbird/[^/]+/bin/netbird'
sudo restorecon -Rv /home/linuxbrew/.linuxbrew/Cellar/netbird
sudo systemctl restart netbird
```
If your Homebrew prefix is set to something other than /home/linuxbrew/.linuxbrew, you may need to adjust those commands to match.
You can verify that the NetBird service is running properly before and after making these changes by running:
```bash
sudo systemctl status netbird
```
</Note>
### Fedora Silverblue / Universal Blue / SteamOS / Immutable Distros (Distrobox)
<Note>
Requires installation of [Distrobox](https://distrobox.it/), Universal Blue images should have Distrobox preinstalled.
</Note>
<Warning>
You will also need to maintain and update Debian inside the Distrobox container.
</Warning>
### Fedora Universal Blue / SteamOS (DistroBox)
1. Create a distrobox container
```bash
distrobox create netbird --init --image debian:12 -a "--cap-add=NET_ADMIN" --additional-packages systemd --root
distrobox create netbird --init --image debian:13 -a "--cap-add=NET_ADMIN" --additional-packages systemd --root
```
2. Install inside the container
```bash
distrobox enter --root netbird
curl -fsSL https://pkgs.netbird.io/install.sh | sh
```
3. Export the distrobird binary to the host
3. Export the Netbird binary to the host
```bash
#from inside the container
distrobox-export -b /usr/bin/netbird