+ {title && (
+
+ {title}
+
+ )}
+ {description && (
+
+ {description}
+
+ )}
+
{items.map((item) => {
let mouseX = useMotionValue(0)
let mouseY = useMotionValue(0)
diff --git a/src/pages/introduction.mdx b/src/pages/introduction.mdx
index 5c3c5f25..e586e1c4 100644
--- a/src/pages/introduction.mdx
+++ b/src/pages/introduction.mdx
@@ -25,52 +25,22 @@ It creates a high-performance point-to-point [WireGuard®](https://www.wireguard
It literally takes less than 5 minutes to deploy a secure point-to-point VPN with NetBird.
This is the quickest way to try self-hosted NetBird. It should take around 5 minutes to get started if you already have a public domain and a VM.
-For advanced setups, see the [Advanced guide](/selfhosted/selfhosted-guide).
-### Requirements
-
-**Infrastructure requirements:**
+## Infrastructure requirements
- A Linux VM with at least **1CPU** and **2GB** of memory.
-- The VM should be publicly accessible on TCP ports **80 (Let's Encrypt)**, **443 (NetBird control plane)**; and UDP ports: **3478 (STUN)**.
-- **Public domain** name pointing to the VM.
+- The VM must be publicly accessible on **TCP ports 80 and 443**, and **UDP port 3478**.
+- A **public domain** name that resolves to the VM’s public IP address.
-**Software requirements:**
-- Docker installed on the VM with the docker compose plugin ([Docker installation guide](https://docs.docker.com/engine/install/)) or docker with docker-compose in version 2 or higher.
-- [jq](https://jqlang.github.io/jq/) installed. In most distributions usually available in the official repositories and can be installed with `sudo apt install jq` or `sudo yum install jq`
-- [curl](https://curl.se/) installed. Usually available in the official repositories and can be installed with `sudo apt install curl` or `sudo yum install curl`
+## Software requirements
-### Download and run the script
+- Docker with docker-compose plugin ([Docker installation guide](https://docs.docker.com/engine/install/)) or Docker with docker-compose version 2 or higher
+- [jq](https://jqlang.github.io/jq/) — install with `sudo apt install jq` or `sudo yum install jq`
+- [curl](https://curl.se/) — install with `sudo apt install curl` or `sudo yum install curl`
+Usually available in the official repositories and can be installed with `sudo apt install curl` or `sudo yum install curl`
+
+## Installation Script
+
+Download and run the installation script:
-Download and run the installation script in a single line:
-```bash
-export NETBIRD_DOMAIN=netbird.example.com; curl -fsSL https://github.com/netbirdio/netbird/releases/latest/download/getting-started.sh | bash
-```
-If you want to check the script before running it, you can download it and run it locally:
```bash
-curl -sSLO https://github.com/netbirdio/netbird/releases/latest/download/getting-started.sh
-# check the script
-cat getting-started.sh
-# run the script
-export NETBIRD_DOMAIN=netbird.example.com
-bash getting-started.sh
+curl -fsSL https://github.com/netbirdio/netbird/releases/latest/download/getting-started.sh | bash
```
-
-Replace `netbird.example.com` with your domain name.
-
+
+Once finished, you can manage the resources via `docker compose`.
An example output of the script:
@@ -94,47 +79,38 @@ You can then log in with your email and password.
The `/setup` page is only accessible when no users exist. After creating the first user, it redirects to the regular login page.
-### Add more users
-
-#### Local users
-
-You can add users directly from the NetBird Dashboard:
-
-
-**Deprecated**: This method is no longer recommended for new installations. It is preserved as a reference for users who deployed NetBird using the Zitadel quickstart script prior to version 0.62. For new installations, use the [quickstart approach](#quick-self-hosting) above.
-
-
-The following instructions apply to deployments using the `getting-started-with-zitadel.sh` script, which bundled Zitadel as an external identity provider.
-
-### Download and run the script
-
-```bash
-export NETBIRD_DOMAIN=netbird.example.com; curl -fsSL https://github.com/netbirdio/netbird/releases/latest/download/getting-started-with-zitadel.sh | bash
-```
-
-If you want to check the script before running it:
-```bash
-curl -sSLO https://github.com/netbirdio/netbird/releases/latest/download/getting-started-with-zitadel.sh
-# check the script
-cat getting-started-with-zitadel.sh
-# run the script
-export NETBIRD_DOMAIN=netbird.example.com
-bash getting-started-with-zitadel.sh
-```
-
-Once the script execution is complete, you can access your NetBird instance via `https://netbird.example.com` using the credentials displayed in your terminal.
-
-### Add users (Zitadel)
-To add additional users, access Zitadel's management console via `https://netbird.example.com/ui/console` with the same credentials. Follow the [Users guide](https://zitadel.com/docs/guides/manage/console/users) from Zitadel to add additional local users or integrate Zitadel with your existing identity provider by following the guide [Configure identity providers](https://zitadel.com/docs/guides/integrate/identity-providers).
-
-### Backup (Zitadel)
-To backup your NetBird installation with Zitadel, you need to copy the configuration files, the Management service databases, and Zitadel's database.
-
-```bash
-mkdir backup
-cp docker-compose.yml Caddyfile zitadel.env dashboard.env turnserver.conf management.json relay.env zdb.env backup/
-```
-
-To save the Management service databases:
-```bash
-docker compose stop management
-docker compose cp -a management:/var/lib/netbird/ backup/
-docker compose start management
-```
-
-You can follow the [Cockroach backup guide](https://www.cockroachlabs.com/docs/stable/backup) to backup Zitadel's database, which holds user information.
-
-### Remove (Zitadel)
-```bash
-# remove all NetBird-related containers and volumes (data)
-docker compose down --volumes
-# remove downloaded and generated config files
-rm -f docker-compose.yml Caddyfile zitadel.env dashboard.env machinekey/zitadel-admin-sa.token turnserver.conf management.json
-```
-
-### Migrating from Zitadel to Local Users
-
-If you have an existing Zitadel deployment and want to migrate:
-
-1. **Option A**: Keep Zitadel as an external provider—add it as an identity provider in Settings
-2. **Option B**: Recreate users as local users and decommission Zitadel
-
-See the [Migration Guide](/selfhosted/identity-providers#migration-guide) for detailed steps.
-
-### Upgrade (Legacy)
-
-
-If upgrading from management version < [v0.15.3](https://github.com/netbirdio/netbird/releases/tag/v0.15.3),
-first upgrade to [v0.25.9](https://github.com/netbirdio/netbird/releases/tag/v0.25.9),
-run management to migrate rules to policies, then upgrade to **0.26.0+**.
-
-
----
-
## Get in touch
-Feel free to ping us on [Slack](/slack-url) if you have any questions
+Feel free to ping us on [Slack](/slack-url) if you have any questions.
- NetBird managed version: [https://app.netbird.io](https://app.netbird.io)
- Make sure to [star us on GitHub](https://github.com/netbirdio/netbird)
-
-
+
+
-
+ 
+
+ 
+
+ 
+
+ 
+
+ 
+
+ 
+
+ 
+
+ 
+
+ 
+
+ 
+
+ 
+
- 
-