Skip to content

Add manual self-hosting and reverse proxy guides #891

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
PizzaLovingNerd wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Add manual self-hosting and reverse proxy guides #891

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
85a109d
docs(self-hosting): add manual Docker Compose setup guide
PizzaLovingNerd Jul 18, 2026
e6dc268
docs(self-hosting): expand manual deployment guides
PizzaLovingNerd Jul 23, 2026
cd3a24c
docs: present multi-container as a supported layout
PizzaLovingNerd Aug 5, 2026
126f27f
address code-rabbit comments
PizzaLovingNerd Aug 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 39 additions & 0 deletions src/components/NavigationDocs.jsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -539,6 +539,45 @@ export const docsNavigation = [
title: 'SELF-HOST NETBIRD',
links: [
{ title: 'Quickstart Guide', href: '/selfhosted/selfhosted-quickstart' },
{
title: 'Manual Setup',
href: '/selfhosted/manual-setup',
isOpen: false,
links: [
{
title: 'Plan Your Deployment',
href: '/selfhosted/manual-setup/planning',
},
{ title: 'Combined Container', href: '/selfhosted/manual-setup' },
{
title: 'Multi-Container',
href: '/selfhosted/manual-setup/multi-container',
},
{
title: 'Reverse Proxies',
href: '/selfhosted/external-reverse-proxy',
isOpen: false,
links: [
{
title: 'Traefik',
href: '/selfhosted/manual-setup/reverse-proxies/traefik',
},
{
title: 'Nginx',
href: '/selfhosted/manual-setup/reverse-proxies/nginx',
},
{
title: 'Caddy',
href: '/selfhosted/manual-setup/reverse-proxies/caddy',
},
{
title: 'Nginx Proxy Manager',
href: '/selfhosted/manual-setup/reverse-proxies/nginx-proxy-manager',
},
],
},
],
},
{ title: 'Automated Setup', href: '/selfhosted/automated-setup' },
{
title: 'Infrastructure as Code',
Expand Down
1,541 changes: 142 additions & 1,399 deletions src/pages/selfhosted/external-reverse-proxy.mdx
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions src/pages/selfhosted/maintenance/configuration-files.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -217,7 +217,7 @@ The STUN port (3478/udp) must always be exposed publicly, regardless of reverse

## config.yaml

The unified configuration file controls the combined NetBird server. It replaces the separate `management.json` and `relay.env` files from older deployments.
The unified configuration file controls the combined NetBird server. Multi-container deployments use separate `management.json` and `relay.env` files instead.
See an example `config.yaml` file in the [NetBird GitHub repository](https://github.com/netbirdio/netbird/blob/main/combined/config.yaml.example).

### Complete Structure
Expand Down Expand Up @@ -547,6 +547,6 @@ See the [Scaling Your Self-Hosted Deployment](/selfhosted/maintenance/scaling/sc
## See Also

- [Self-hosting Quickstart Guide](/selfhosted/selfhosted-quickstart) - Get started quickly with default settings
- [External Reverse Proxy Configuration](/selfhosted/external-reverse-proxy) - Nginx, Caddy, NPM, HAProxy setup
- [External Reverse Proxy Configuration](/selfhosted/external-reverse-proxy) - Traefik, Nginx, Caddy, and Nginx Proxy Manager setup
- [Management SQLite Store](/selfhosted/maintenance/sqlite-store) - SQLite database details
- [Management Postgres Store](/selfhosted/maintenance/postgres-store) - PostgreSQL setup
Loading
Loading