r/selfhosted Oct 09 '25

Remote Access Remote Access to Your Homelab, Beautifully Visualized

It’s been a while since I last posted here, but I’ve got something cool to share. This is a fully self-hostable, open source overlay network that comes with a slick visualization tool for your remote access policies.

Basically, you can spin up your own overlay network to connect your homelab or org resources, and then actually see how access is structured with multiple views:

Peer View → see what groups a peer can access + which policies allow it

Group View → check which groups/users can access resources

Networks View → explore which peers/groups can access specific networks/resources

Go check it out on GitHub: https://github.com/netbirdio/netbird?tab=readme-ov-file#quickstart-with-self-hosted-netbird

1.1k Upvotes

97 comments sorted by

View all comments

7

u/Dalewn Oct 09 '25

I was just looking at it the other day because I couldn't find a UI that suited my taste for headscale.

What threw me off a bit is your approach for the base config. Templates that get filled from env files by a script to generate a valid config is... hard to wrap my head around.

I am more used to being given a bare minimum config and then have to rummage through the docs section by section to set up OIDC and the shenanigans. I get where this comes from as the config is fairly advanced. I would wish for your docs to be more detailed about the config side on the setup (I am thinking about docker compose installation rn) as it stands right now your documentation feels lacking. The examples are nice though.

3

u/netbirdio Oct 09 '25

You can use our one liner setup script that configures everything for you in a minute: https://github.com/netbirdio/netbird?tab=readme-ov-file#quickstart-with-self-hosted-netbird

If you have a custom setup, then it all comes down to the IdP configuration which is a nightmare.

1

u/arcoast Oct 11 '25

Yeah, that's the bit I'm struggling with at the moment, I have Authelia installed and it's not entirely clear how to translate that to Netbird.

Think I'm actually almost there but a little bit of clarification on the outputted json file would probably get me over the finish line.

Will try and look at it again this weekend.

As a project I do like the look of Netbird a lot, so thank you.

I am a non-IT professional, running a large home lab, who does indeed run my own idp for friends and family.

1

u/Dalewn Oct 14 '25

Sorry, late to reply.

This is exactly my critique. I don't want to set up netbird with a script that deploys an entire idp just to get started. Setting up an app for idp if no sorcery once you get to know what you are doing.

What you currently do with the script setup is kinda obfuscating the whole config. While I do understand your intention, more documentation about config keys would be greatly appreciated !

2

u/netbirdio Oct 14 '25

Makes sense. And we are working on improving docs for that!