[GH-ISSUE #5334] Zitadel Migration Tool #11257

New Issue

saavagebueno · 2026-08-05T01:29:05-04:00

saavagebueno commented

2026-08-05 01:29:05 -04:00

Originally created by @07ke on GitHub (Feb 15, 2026).
Original GitHub issue: https://github.com/netbirdio/netbird/issues/5334

Originally assigned to: @jnfrati on GitHub.

Hi,

I noticed that you are working on a migration tool to automate the process of switching from standalone IdPs to external providers.

We are very interested in this feature and would like to learn more about it. Could you please let us know:

How we can access or try this migration tool?

Whether it is currently available (beta/preview/GA)?

If there are any prerequisites or documentation available?

Looking forward to your reply. Thank you!

https://docs.netbird.io/selfhosted/identity-providers#migration-guide-and-backwards-compatibility

Originally created by @07ke on GitHub (Feb 15, 2026). Original GitHub issue: https://github.com/netbirdio/netbird/issues/5334 Originally assigned to: @jnfrati on GitHub. Hi, I noticed that you are working on a migration tool to automate the process of switching from standalone IdPs to external providers. We are very interested in this feature and would like to learn more about it. Could you please let us know: How we can access or try this migration tool? Whether it is currently available (beta/preview/GA)? If there are any prerequisites or documentation available? Looking forward to your reply. Thank you! https://docs.netbird.io/selfhosted/identity-providers#migration-guide-and-backwards-compatibility

saavagebueno closed this issue

2026-08-05 01:29:05 -04:00

saavagebueno commented

2026-08-05 01:29:05 -04:00

@quietPL83 commented on GitHub (Feb 16, 2026):

I am also interested.

@quietPL83 commented on GitHub (Feb 16, 2026): I am also interested.

saavagebueno commented

2026-08-05 01:29:05 -04:00

@SuperKali commented on GitHub (Feb 20, 2026):

+1 So interested, hope this can be addressed soon

@SuperKali commented on GitHub (Feb 20, 2026): +1 So interested, hope this can be addressed soon

saavagebueno commented

2026-08-05 01:29:05 -04:00

@07ke commented on GitHub (Feb 20, 2026):

migrate.sh X

==========================================
  NetBird Migration Tool v1.0.0
  Pre-v0.65.0 → Combined Container Setup
==========================================

[INFO] Checking dependencies...
[OK] All dependencies found (docker compose: 'docker-compose')
[INFO] Validating old setup...
[OK] Found management.json at: /root/netbirdio/management.json
[INFO] Detecting reverse proxy type...
[INFO] Detected: Caddy reverse proxy (in Docker Compose)
[INFO] Detecting identity provider type...
[ERROR] External IdP detected: zitadel

This migration script only supports embedded IdP setups.
External IdP providers (Auth0, Keycloak, Zitadel, etc.) require
a fresh installation using getting-started.sh.

Please refer to the NetBird documentation for upgrade instructions:
  https://docs.netbird.io/selfhosted/getting-started

@07ke commented on GitHub (Feb 20, 2026): migrate.sh X ``` ========================================== NetBird Migration Tool v1.0.0 Pre-v0.65.0 → Combined Container Setup ========================================== [INFO] Checking dependencies... [OK] All dependencies found (docker compose: 'docker-compose') [INFO] Validating old setup... [OK] Found management.json at: /root/netbirdio/management.json [INFO] Detecting reverse proxy type... [INFO] Detected: Caddy reverse proxy (in Docker Compose) [INFO] Detecting identity provider type... [ERROR] External IdP detected: zitadel This migration script only supports embedded IdP setups. External IdP providers (Auth0, Keycloak, Zitadel, etc.) require a fresh installation using getting-started.sh. Please refer to the NetBird documentation for upgrade instructions: https://docs.netbird.io/selfhosted/getting-started ```

saavagebueno commented

2026-08-05 01:29:05 -04:00

@WithdewHua commented on GitHub (Feb 23, 2026):

+1 looking forward to migrating from standalone IdPs to embedded IdPs

@WithdewHua commented on GitHub (Feb 23, 2026): +1 looking forward to migrating from standalone IdPs to embedded IdPs

saavagebueno commented

2026-08-05 01:29:05 -04:00

@kovsrdjan commented on GitHub (Feb 23, 2026):

+1 - migrate.sh looks promising, but external IdPs (Zitadel) support in the migration process would be awesome.

@kovsrdjan commented on GitHub (Feb 23, 2026): +1 - migrate.sh looks promising, but external IdPs (Zitadel) support in the migration process would be awesome.

saavagebueno commented

2026-08-05 01:29:05 -04:00

@pernetz commented on GitHub (Apr 13, 2026):

Here is the migration guide for changing over from Zitadel to embedded IdP: https://docs.netbird.io/selfhosted/migration/external-to-embedded-idp

First you must switch to embedded IdP, then you can run the migration to combined server via migrate.sh supported by this guide: https://docs.netbird.io/selfhosted/migration/combined-container

@pernetz commented on GitHub (Apr 13, 2026): Here is the migration guide for changing over from Zitadel to embedded IdP: [https://docs.netbird.io/selfhosted/migration/external-to-embedded-idp](url) First you must switch to embedded IdP, then you can run the migration to combined server via `migrate.sh` supported by this guide: [https://docs.netbird.io/selfhosted/migration/combined-container](url)

saavagebueno commented

2026-08-05 01:29:05 -04:00

@07ke commented on GitHub (Apr 13, 2026):

[root@hk-2 netbirdio]# ./migrate --domain xxx.com
2026-04-14T09:26:53.003+08:00 INFO management/server/store/store.go:370: using SQLite store engine
2026-04-14T09:26:53.004+08:00 INFO management/server/store/sql_store.go:105: Setting transaction timeout to 5m0s
2026-04-14T09:26:53.004+08:00 INFO management/server/store/sql_store.go:119: Set max open db connections to 1, max idle to 1, max lifetime to 1h0m0s, max idle time to 3m0s
2026-04-14T09:26:53.004+08:00 INFO management/server/store/sql_store.go:123: skipping migration
2026-04-14T09:26:53.004+08:00 INFO management/server/activity/store/sql_store.go:270: using sqlite as activity event store engine
2026-04-14T09:26:53.004+08:00 INFO management/server/activity/store/sql_store.go:299: Set max open db connections to 1, max idle to 1, max lifetime to 1h0m0s, max idle time to 3m0s
2026-04-14T09:26:53.005+08:00 INFO management/server/migration/migration.go:344: No rows with empty name found in table deleted_users, no migration needed
2026-04-14T09:26:53.005+08:00 INFO management/server/migration/migration.go:358: Migration of empty name to default value in table deleted_users completed
2026-04-14T09:26:53.005+08:00 INFO management/server/migration/migration.go:344: No rows with empty enc_algo found in table deleted_users, no migration needed
2026-04-14T09:26:53.005+08:00 INFO management/server/migration/migration.go:358: Migration of empty enc_algo to default value in table deleted_users completed
2026-04-14T09:26:53.008+08:00 INFO tools/idp-migrate/main.go:128: database schema check passed
2026-04-14T09:26:53.008+08:00 INFO tools/idp-migrate/main.go:162: created IDP manager (type: zitadel)
2026-04-14T09:26:53.008+08:00 INFO management/server/store/store.go:370: using SQLite store engine
2026-04-14T09:26:53.008+08:00 INFO management/server/store/sql_store.go:105: Setting transaction timeout to 5m0s
2026-04-14T09:26:53.009+08:00 INFO management/server/store/sql_store.go:119: Set max open db connections to 1, max idle to 1, max lifetime to 1h0m0s, max idle time to 3m0s
2026-04-14T09:26:53.009+08:00 INFO management/server/store/sql_store.go:123: skipping migration
2026-04-14T09:26:53.009+08:00 INFO management/server/activity/store/sql_store.go:270: using sqlite as activity event store engine
2026-04-14T09:26:53.009+08:00 INFO management/server/activity/store/sql_store.go:299: Set max open db connections to 1, max idle to 1, max lifetime to 1h0m0s, max idle time to 3m0s
2026-04-14T09:26:53.009+08:00 INFO management/server/migration/migration.go:344: No rows with empty name found in table deleted_users, no migration needed
2026-04-14T09:26:53.009+08:00 INFO management/server/migration/migration.go:358: Migration of empty name to default value in table deleted_users completed
2026-04-14T09:26:53.009+08:00 INFO management/server/migration/migration.go:344: No rows with empty enc_algo found in table deleted_users, no migration needed
2026-04-14T09:26:53.009+08:00 INFO management/server/migration/migration.go:358: Migration of empty enc_algo to default value in table deleted_users completed
2026-04-14T09:26:53.563+08:00 INFO management/server/idp/migration/migration.go:171: fetched 4 users from IDP
2026-04-14T09:26:53.572+08:00 INFO management/server/idp/migration/migration.go:224: updated user 299779303514570756: email="admin@xxx.com", name="Zitadel Admin"
2026-04-14T09:26:53.572+08:00 INFO management/server/idp/migration/migration.go:231: user info population complete: 1 updated, 0 skipped, 0 not found in IDP
2026-04-14T09:26:53.572+08:00 INFO tools/idp-migrate/main.go:86: resolved connector: type=oidc, id=299779288918392836, name=NETBIRD
2026-04-14T09:26:53.572+08:00 INFO management/server/store/store.go:370: using SQLite store engine
2026-04-14T09:26:53.573+08:00 INFO management/server/store/sql_store.go:105: Setting transaction timeout to 5m0s
2026-04-14T09:26:53.574+08:00 INFO management/server/store/sql_store.go:119: Set max open db connections to 1, max idle to 1, max lifetime to 1h0m0s, max idle time to 3m0s
2026-04-14T09:26:53.574+08:00 INFO management/server/store/sql_store.go:123: skipping migration
2026-04-14T09:26:53.574+08:00 INFO management/server/activity/store/sql_store.go:270: using sqlite as activity event store engine
2026-04-14T09:26:53.574+08:00 INFO management/server/activity/store/sql_store.go:299: Set max open db connections to 1, max idle to 1, max lifetime to 1h0m0s, max idle time to 3m0s
2026-04-14T09:26:53.574+08:00 INFO management/server/migration/migration.go:344: No rows with empty name found in table deleted_users, no migration needed
2026-04-14T09:26:53.574+08:00 INFO management/server/migration/migration.go:358: Migration of empty name to default value in table deleted_users completed
2026-04-14T09:26:53.575+08:00 INFO management/server/migration/migration.go:344: No rows with empty enc_algo found in table deleted_users, no migration needed
2026-04-14T09:26:53.575+08:00 INFO management/server/migration/migration.go:358: Migration of empty enc_algo to default value in table deleted_users completed
2026-04-14T09:26:53.578+08:00 INFO tools/idp-migrate/main.go:274: found 1 total users: 1 pending migration, 0 already migrated
2026-04-14T09:26:53.578+08:00 INFO tools/idp-migrate/main.go:280: About to migrate 1 users. This cannot be easily undone. Continue? [y/N]
y
2026-04-14T09:27:02.003+08:00 INFO management/server/store/sql_store_idp_migration.go:140: Updating user ID in the store
2026-04-14T09:27:02.035+08:00 INFO management/server/store/sql_store_idp_migration.go:163: Restoring FK constraints
2026-04-14T09:27:02.075+08:00 INFO management/server/idp/migration/migration.go:109: migration complete: 1 users migrated, 0 already migrated
2026-04-14T09:27:02.075+08:00 INFO tools/idp-migrate/main.go:252: DB migration completed successfully
2026-04-14T09:27:02.076+08:00 INFO tools/idp-migrate/main.go:399: backed up original config to /root/netbirdio/management.json.bak
2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:405: wrote new config to /root/netbirdio/management.json
2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:430: Congratulations! You have successfully migrated your NetBird management server to the embedded Dex IdP.
2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:431: Next steps:
2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:432: 1. Make sure the following environment variables are set for your dashboard server:
2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:433:
AUTH_AUDIENCE=netbird-dashboard
AUTH_CLIENT_ID=netbird-dashboard
AUTH_AUTHORITY=https://xxx.com/oauth2
AUTH_SUPPORTED_SCOPES=openid profile email groups
AUTH_REDIRECT_URI=/nb-auth
AUTH_SILENT_REDIRECT_URI=/nb-silent-auth

2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:443: 2. Make sure you restart the dashboard & management servers to pick up the new config and environment variables.
2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:444: eg. docker compose up -d --force-recreate management dashboard
2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:445: 3. Optional: If you have a reverse proxy configured, make sure the path `/oauth2/*` points to the management api server.

The previously built-in Zitadel is completely unusable after migration. Email login shows ‘incorrect username or password.’ Using OIDC shows that the application does not exist.

@07ke commented on GitHub (Apr 13, 2026): ``` [root@hk-2 netbirdio]# ./migrate --domain xxx.com 2026-04-14T09:26:53.003+08:00 INFO management/server/store/store.go:370: using SQLite store engine 2026-04-14T09:26:53.004+08:00 INFO management/server/store/sql_store.go:105: Setting transaction timeout to 5m0s 2026-04-14T09:26:53.004+08:00 INFO management/server/store/sql_store.go:119: Set max open db connections to 1, max idle to 1, max lifetime to 1h0m0s, max idle time to 3m0s 2026-04-14T09:26:53.004+08:00 INFO management/server/store/sql_store.go:123: skipping migration 2026-04-14T09:26:53.004+08:00 INFO management/server/activity/store/sql_store.go:270: using sqlite as activity event store engine 2026-04-14T09:26:53.004+08:00 INFO management/server/activity/store/sql_store.go:299: Set max open db connections to 1, max idle to 1, max lifetime to 1h0m0s, max idle time to 3m0s 2026-04-14T09:26:53.005+08:00 INFO management/server/migration/migration.go:344: No rows with empty name found in table deleted_users, no migration needed 2026-04-14T09:26:53.005+08:00 INFO management/server/migration/migration.go:358: Migration of empty name to default value in table deleted_users completed 2026-04-14T09:26:53.005+08:00 INFO management/server/migration/migration.go:344: No rows with empty enc_algo found in table deleted_users, no migration needed 2026-04-14T09:26:53.005+08:00 INFO management/server/migration/migration.go:358: Migration of empty enc_algo to default value in table deleted_users completed 2026-04-14T09:26:53.008+08:00 INFO tools/idp-migrate/main.go:128: database schema check passed 2026-04-14T09:26:53.008+08:00 INFO tools/idp-migrate/main.go:162: created IDP manager (type: zitadel) 2026-04-14T09:26:53.008+08:00 INFO management/server/store/store.go:370: using SQLite store engine 2026-04-14T09:26:53.008+08:00 INFO management/server/store/sql_store.go:105: Setting transaction timeout to 5m0s 2026-04-14T09:26:53.009+08:00 INFO management/server/store/sql_store.go:119: Set max open db connections to 1, max idle to 1, max lifetime to 1h0m0s, max idle time to 3m0s 2026-04-14T09:26:53.009+08:00 INFO management/server/store/sql_store.go:123: skipping migration 2026-04-14T09:26:53.009+08:00 INFO management/server/activity/store/sql_store.go:270: using sqlite as activity event store engine 2026-04-14T09:26:53.009+08:00 INFO management/server/activity/store/sql_store.go:299: Set max open db connections to 1, max idle to 1, max lifetime to 1h0m0s, max idle time to 3m0s 2026-04-14T09:26:53.009+08:00 INFO management/server/migration/migration.go:344: No rows with empty name found in table deleted_users, no migration needed 2026-04-14T09:26:53.009+08:00 INFO management/server/migration/migration.go:358: Migration of empty name to default value in table deleted_users completed 2026-04-14T09:26:53.009+08:00 INFO management/server/migration/migration.go:344: No rows with empty enc_algo found in table deleted_users, no migration needed 2026-04-14T09:26:53.009+08:00 INFO management/server/migration/migration.go:358: Migration of empty enc_algo to default value in table deleted_users completed 2026-04-14T09:26:53.563+08:00 INFO management/server/idp/migration/migration.go:171: fetched 4 users from IDP 2026-04-14T09:26:53.572+08:00 INFO management/server/idp/migration/migration.go:224: updated user 299779303514570756: email="admin@xxx.com", name="Zitadel Admin" 2026-04-14T09:26:53.572+08:00 INFO management/server/idp/migration/migration.go:231: user info population complete: 1 updated, 0 skipped, 0 not found in IDP 2026-04-14T09:26:53.572+08:00 INFO tools/idp-migrate/main.go:86: resolved connector: type=oidc, id=299779288918392836, name=NETBIRD 2026-04-14T09:26:53.572+08:00 INFO management/server/store/store.go:370: using SQLite store engine 2026-04-14T09:26:53.573+08:00 INFO management/server/store/sql_store.go:105: Setting transaction timeout to 5m0s 2026-04-14T09:26:53.574+08:00 INFO management/server/store/sql_store.go:119: Set max open db connections to 1, max idle to 1, max lifetime to 1h0m0s, max idle time to 3m0s 2026-04-14T09:26:53.574+08:00 INFO management/server/store/sql_store.go:123: skipping migration 2026-04-14T09:26:53.574+08:00 INFO management/server/activity/store/sql_store.go:270: using sqlite as activity event store engine 2026-04-14T09:26:53.574+08:00 INFO management/server/activity/store/sql_store.go:299: Set max open db connections to 1, max idle to 1, max lifetime to 1h0m0s, max idle time to 3m0s 2026-04-14T09:26:53.574+08:00 INFO management/server/migration/migration.go:344: No rows with empty name found in table deleted_users, no migration needed 2026-04-14T09:26:53.574+08:00 INFO management/server/migration/migration.go:358: Migration of empty name to default value in table deleted_users completed 2026-04-14T09:26:53.575+08:00 INFO management/server/migration/migration.go:344: No rows with empty enc_algo found in table deleted_users, no migration needed 2026-04-14T09:26:53.575+08:00 INFO management/server/migration/migration.go:358: Migration of empty enc_algo to default value in table deleted_users completed 2026-04-14T09:26:53.578+08:00 INFO tools/idp-migrate/main.go:274: found 1 total users: 1 pending migration, 0 already migrated 2026-04-14T09:26:53.578+08:00 INFO tools/idp-migrate/main.go:280: About to migrate 1 users. This cannot be easily undone. Continue? [y/N] y 2026-04-14T09:27:02.003+08:00 INFO management/server/store/sql_store_idp_migration.go:140: Updating user ID in the store 2026-04-14T09:27:02.035+08:00 INFO management/server/store/sql_store_idp_migration.go:163: Restoring FK constraints 2026-04-14T09:27:02.075+08:00 INFO management/server/idp/migration/migration.go:109: migration complete: 1 users migrated, 0 already migrated 2026-04-14T09:27:02.075+08:00 INFO tools/idp-migrate/main.go:252: DB migration completed successfully 2026-04-14T09:27:02.076+08:00 INFO tools/idp-migrate/main.go:399: backed up original config to /root/netbirdio/management.json.bak 2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:405: wrote new config to /root/netbirdio/management.json 2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:430: Congratulations! You have successfully migrated your NetBird management server to the embedded Dex IdP. 2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:431: Next steps: 2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:432: 1. Make sure the following environment variables are set for your dashboard server: 2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:433: AUTH_AUDIENCE=netbird-dashboard AUTH_CLIENT_ID=netbird-dashboard AUTH_AUTHORITY=https://xxx.com/oauth2 AUTH_SUPPORTED_SCOPES=openid profile email groups AUTH_REDIRECT_URI=/nb-auth AUTH_SILENT_REDIRECT_URI=/nb-silent-auth 2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:443: 2. Make sure you restart the dashboard & management servers to pick up the new config and environment variables. 2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:444: eg. docker compose up -d --force-recreate management dashboard 2026-04-14T09:27:02.077+08:00 INFO tools/idp-migrate/main.go:445: 3. Optional: If you have a reverse proxy configured, make sure the path `/oauth2/*` points to the management api server. ``` The previously built-in Zitadel is completely unusable after migration. Email login shows ‘incorrect username or password.’ Using OIDC shows that the application does not exist.

saavagebueno commented

2026-08-05 01:29:05 -04:00

@jnfrati commented on GitHub (Apr 14, 2026):

Hey @07ke, could you check that:

management.json contains the proper StaticConnector with the new Zitadel OIDC app you created?
the dashboard.env variables are extremely important for the embedded IdP to work properly, could you check if they are applied by doing a docker compose up -d --force-recreate?

When you're trying to log-in to the netbird dashboard are you automatically redirected to Zitadel? Or are you shown the options "Continue with Email" and "Continue with Zitadel"?

@jnfrati commented on GitHub (Apr 14, 2026): Hey @07ke, could you check that: - management.json contains the proper StaticConnector with the new Zitadel OIDC app you created? - the dashboard.env variables are extremely important for the embedded IdP to work properly, could you check if they are applied by doing a `docker compose up -d --force-recreate`? When you're trying to log-in to the netbird dashboard are you automatically redirected to Zitadel? Or are you shown the options "Continue with Email" and "Continue with Zitadel"?

saavagebueno commented

2026-08-05 01:29:06 -04:00

@07ke commented on GitHub (Apr 14, 2026):

Hey @07ke, could you check that:

management.json contains the proper StaticConnector with the new Zitadel OIDC app you created?

the dashboard.env variables are extremely important for the embedded IdP to work properly, could you check if they are applied by doing a docker compose up -d --force-recreate?

When you're trying to log-in to the netbird dashboard are you automatically redirected to Zitadel? Or are you shown the options "Continue with Email" and "Continue with Zitadel"?

I didn’t create a new Zitadel because I’m using the one that was built into my previous installation. I copied the clientID and clientSecret from the old management.json.

In dashboard.env, only these three values were different from my old configuration, and I’ve updated them to:

AUTH_AUDIENCE=netbird-dashboard
AUTH_CLIENT_ID=netbird-dashboard
AUTH_AUTHORITY=https://xxx.com/oauth2
AUTH_SUPPORTED_SCOPES=openid profile email groups

Everything works fine except that I can’t log into NetBird. I’ve already done a force-recreate.

@07ke commented on GitHub (Apr 14, 2026): > Hey [@07ke](https://github.com/07ke), could you check that: > > * management.json contains the proper StaticConnector with the new Zitadel OIDC app you created? > * the dashboard.env variables are extremely important for the embedded IdP to work properly, could you check if they are applied by doing a `docker compose up -d --force-recreate`? > > When you're trying to log-in to the netbird dashboard are you automatically redirected to Zitadel? Or are you shown the options "Continue with Email" and "Continue with Zitadel"? I didn’t create a new Zitadel because I’m using the one that was built into my previous installation. I copied the clientID and clientSecret from the old `management.json`. In `dashboard.env`, only these three values were different from my old configuration, and I’ve updated them to: ``` AUTH_AUDIENCE=netbird-dashboard AUTH_CLIENT_ID=netbird-dashboard AUTH_AUTHORITY=https://xxx.com/oauth2 AUTH_SUPPORTED_SCOPES=openid profile email groups ``` Everything works fine except that I can’t log into NetBird. I’ve already done a force-recreate.

saavagebueno commented

2026-08-05 01:29:06 -04:00

@jnfrati commented on GitHub (Apr 14, 2026):

Right, the instructions on "Prepare your provider" were added because the old application that was created for Zitadel does not work with the new embedded IdP, and it was simpler to instruct people on create a new one.

If you want to keep your existing Zitadel app (same client id and client secret), you will need the application to match the options we share here https://docs.netbird.io/selfhosted/identity-providers/zitadel

Type: Web
Authentication Method: Code
Make sure your callback is now under https://xxx.com/oauth2/callback
And token settings should match for proper behavior but shouldn't block you from logging in

Hope that solves the issue! If it's still failing after that please let me know 🙌

@jnfrati commented on GitHub (Apr 14, 2026): Right, the instructions on "[Prepare your provider](https://docs.netbird.io/selfhosted/migration/external-to-embedded-idp#step-3-prepare-your-provider)" were added because the old application that was created for Zitadel does not work with the new embedded IdP, and it was simpler to instruct people on create a new one. If you want to keep your existing Zitadel app (same client id and client secret), you will need the application to match the options we share here https://docs.netbird.io/selfhosted/identity-providers/zitadel - Type: Web - Authentication Method: Code - Make sure your callback is now under https://xxx.com/oauth2/callback - And token settings should match for proper behavior but shouldn't block you from logging in Hope that solves the issue! If it's still failing after that please let me know 🙌

saavagebueno commented

2026-08-05 01:29:06 -04:00

@07ke commented on GitHub (Apr 14, 2026):

Can’t you add a new administrator to the Embedded IdP? Or can you export the current system configuration rules? I plan to reinstall NetBird and then import the data back.

@07ke commented on GitHub (Apr 14, 2026): Can’t you add a new administrator to the Embedded IdP? Or can you export the current system configuration rules? I plan to reinstall NetBird and then import the data back.

saavagebueno commented

2026-08-05 01:29:06 -04:00

@jnfrati commented on GitHub (Apr 14, 2026):

Were you able to try out the solution I sent? I'm pretty sure it's a configuration issue that can be solved without a fresh install. Happy to assist on slack as well if you want to send a message there.

Either way, if you need to add an owner you should be able to set the server.auth.owner parameter to get a local user https://docs.netbird.io/selfhosted/configuration-files#authentication-settings

Make sure to add the email and password so that the owner is created on the spot

@jnfrati commented on GitHub (Apr 14, 2026): Were you able to try out the solution I sent? I'm pretty sure it's a configuration issue that can be solved without a fresh install. Happy to assist on slack as well if you want to send a message there. Either way, if you need to add an owner you should be able to set the `server.auth.owner` parameter to get a local user https://docs.netbird.io/selfhosted/configuration-files#authentication-settings Make sure to add the email and password so that the owner is created on the spot

saavagebueno commented

2026-08-05 01:29:06 -04:00

@07ke commented on GitHub (Apr 14, 2026):

Okay, I'll try it tomorrow and let you know the result.

@07ke commented on GitHub (Apr 14, 2026): Okay, I'll try it tomorrow and let you know the result.

saavagebueno commented

2026-08-05 01:29:06 -04:00

@07ke commented on GitHub (Apr 15, 2026):

Built-in ZITADEL Guide for Legacy Installer

Step 3: Prepare Your Provider

1. Open the Console

Go to:
https://example.com/ui/console/

2. Open the NETBIRD Project

3. Create a Web Application

4. Enter a Name

Provide a name for your application.

5. Select Authorization Code Flow

Make sure the Code option is selected.

6. Enter Your Domain

Fill in your domain information as required.

7. Modify the `connector.json` File

{
  "issuer": "https://example.com",
  "clientID": "my-client-id",
  "clientSecret": "my-client-secret"
}

8. Edit AuthToken

(。・＿・。)ﾉ~ Everything else is consistent with the tutorial.

@07ke commented on GitHub (Apr 15, 2026): # Built-in ZITADEL Guide for Legacy Installer ## Step 3: Prepare Your Provider ### 1. Open the Console Go to: [https://example.com/ui/console/](https://example.com/ui/console/) --- ### 2. Open the **NETBIRD** Project <img width="1784" height="1011" alt="Image" src="https://github.com/user-attachments/assets/ffb45067-bb21-405b-a4c3-f239b22f15b9" /> --- ### 3. Create a Web Application <img width="1512" height="444" alt="Image" src="https://github.com/user-attachments/assets/5e0d2be9-5b02-42fe-8417-b776811f3681" /> --- ### 4. Enter a Name Provide a name for your application. <img width="2131" height="1275" alt="Image" src="https://github.com/user-attachments/assets/fa599709-38cb-4e83-8991-cd6e534228ae" /> --- ### 5. Select **Authorization Code Flow** Make sure the **Code** option is selected. <img width="2237" height="1119" alt="Image" src="https://github.com/user-attachments/assets/745ebfae-1694-4b69-a92f-4c1b1ac65746" /> --- ### 6. Enter Your Domain Fill in your domain information as required. <img width="2220" height="1200" alt="Image" src="https://github.com/user-attachments/assets/ea96a224-5451-4bad-b1f1-c24024b709d6" /> --- ### 7. Modify the `connector.json` File <img width="1875" height="786" alt="Image" src="https://github.com/user-attachments/assets/35b49012-373f-4e72-ac0b-a72717d15080" /> ```json { "issuer": "https://example.com", "clientID": "my-client-id", "clientSecret": "my-client-secret" } ``` ### 8. Edit AuthToken <img width="1609" height="1429" alt="Image" src="https://github.com/user-attachments/assets/f15c9013-e0d5-4969-a74b-19e721db02c3" /> > (。・＿・。)ﾉ~ Everything else is consistent with the tutorial.

Sign in to join this conversation.

Branches Tags

main

claude/agent-network-test-cases-p743vw

android/gui-integration

revert/component-types

feat-post_quantum_ml_kem

ice-stun-wg-demux

dependabot/npm_and_yarn/proxy/web/npm_and_yarn-b39864987c

agent-network-setup-poc

dependabot/go_modules/aws-sdk-8f849ebaed

dependabot/github_actions/actions-a940c7c866

dependabot/go_modules/otel-e34c790afd

dependabot/go_modules/testcontainers-de325c0dd6

dependabot/go_modules/wireguard-dbd6b95108

dependabot/go_modules/pion-5f703e1eca

dependabot/go_modules/gorm-2271c8195b

fix-login-needed-check

dependabot/go_modules/google.golang.org/grpc-1.82.1

fix/ui-gtk3-support

enterprise-traefik-and-migration-fixes

disambiguate_p2p_metrics

revert/component-types-hookup

embedded-vnc

feature/ios-ssh

docs/agent-network-docs-update

dependabot/go_modules/github.com/aws/aws-sdk-go-v2/service/s3-1.106.3

dependabot/go_modules/github.com/pion/stun/v3-3.1.5

fix-ssh-authorized-users-multi-rule

peer-acl-multi-source

reverse-proxy-crowdsec-appsec

reverse-proxy-allow-match-or

client-local-metrics

lazy-conn-per-peer

lazy-conn-rosenpass

dependabot/go_modules/github.com/gopacket/gopacket-1.7.0

dependabot/go_modules/goauthentik.io/api/v3-3.2026050.6

dependabot/go_modules/github.com/pires/go-proxyproto-0.15.0

dependabot/go_modules/github.com/jackc/pgx/v5-5.10.0

dependabot/go_modules/github.com/oapi-codegen/runtime-1.6.0

dependabot/go_modules/github.com/eko/gocache/lib/v4-4.2.4

dependabot/go_modules/github.com/pkg/sftp-1.13.11

dependabot/go_modules/github.com/coreos/go-oidc/v3-3.20.0

ssh-windows-privilege-check

fix/explicit-cors-handling

fix/remove-math-rand

test/gui-memory-leak-fix

fix/ui-status-dispatch

install-script-ui-dependencies

fix/grpc-get-network-map

fix/subscribe-status-coalesce

fix/tray-menu-item-leak

fix/windows-tray-race

feature/changeset

worktree-dns-route-qtype-fallthrough

mdm_integration

mlsmaycon-patch-2

feat/agent-network-ollama

proxy-tunnel-cache-ttl-env

coderabbitai/utg/1e5b0a5

grpc-acl

test/battery-drain

components-impl-drop-indexes-use-xids-no-resource-policy-map

fix/nmap-relevant-groups

e2e-guardrail-blocks-unselected-model

fix/lazyconn-cold-start-allowed-ips

vertex-guardrails-model-access-e2e

add-atomic-cache-ops

refactor/relay-foreign-cache

ci/trigger-release-tests

feature/kimi-3-agent-networks-dns-warmup

feature/dns-lazy-conn-warmup

daemon-ipc-acl

feature/ui-translation-key-parity-check

refactor/relay-foreign-cache-tests

fix/lazyconn-idle-keep-wg-peer

dmitri-propagate-auth-grant-types-on-combined

0.74.7-branch

diagnose-empty-vs-corrupt-state

windows-sleep-detector

fix/cli-up-wait-for-daemon

rp_key_persistency

feature/native-grpc

0.74.6-branch

0.74.6-branch-sync

0.74.5-branch-sync

0.74.4-branch

fix/remove-stale-peers-removal

fix/remove-stale-proxy-logic

fix/nsis-preserve-autostart-on-upgrade

refactor/peer-event-bus

dependabot/go_modules/goauthentik.io/api/v3-3.2026050.3

dependabot/go_modules/github.com/pkg/sftp-1.13.10

components-impl-drop-indexes

fix-reset-aggregation-window-flake

dependabot/go_modules/github.com/pion/dtls/v3-3.1.5

0.74.x

fix/relay-states-lock

update-process-pkg

update-gopsutil-v4

fix/relay_states_lock

increase-sysinfo-timeout

dependabot/go_modules/github.com/Azure/go-ntlmssp-0.1.1

dependabot/go_modules/github.com/eko/gocache/store/redis/v4-4.2.6

dependabot/go_modules/github.com/eko/gocache/lib/v4-4.2.3

fix/fail-to-create-upnp-port-mapping-on-opnsense-firewall

0.74.3-branch

fix/routeselector-atomic-exit-node

netmap_progressive_alignment

nmap/components-impl

dependabot/go_modules/github.com/jackc/pgx/v5-5.9.2

dependabot/go_modules/github.com/oapi-codegen/runtime-1.4.2

dependabot/go_modules/github.com/gopacket/gopacket-1.6.1

dependabot/go_modules/github.com/coreos/go-oidc/v3-3.19.0

dependabot/go_modules/github.com/pires/go-proxyproto-0.12.0

fix/signal-watchdog-sync-stop

docs/agent-network

test/affected-logic

fix/revert-ice-filter

refactor/simplify-affected-peers

pascal-filter-policies-by-direction

claude/lock-contention-peer-connect-g8t6au

dmitri-filter-policies-by-direction

refactor/migrate-profiles-to-go

profile-bindings-ios

fix/skip-restart-unchanged-route

fix/mgmt-cache-async-resolve

refactor/wails-update-105

client_lifetime_serialization_refactor

fix/browser-ssh-2

fix/ipv6-and-netstack-accept-loop

fix/browser-ssh

profile-id-name-test

refactor/mgmt-bootstrap

feat/getting-started-unified-wizard

socket-grpc-permissions

fix/mysql-index-migration

windows-dns-firewall

tests/enable-race-on-tests

ui-refactor-gtk3

feature/affected-peers-grpc

profile-id

lazyconn-first-packet-fix-v2

claude/focused-gates-VMTgb

ui-tray-linux-leftclick

fix/ctx-enrichment

daemon-owner

feature/android-client-ssh

worktree-accept-ra-forwarding

nmap/combined-deploy

task/align_protobuff_toolset

feature/session-extend

add-json-yaml-flags

refactor/ephemeral-cleanup

claude/webtransport-relay-wasm-mUjY9

claude/vnc-udp-feasibility-6KB1U

fix/wgport-config

e2e-windows-dns-combined

fix/login-cmd-root-flags

feat/reseller-openapi-spec

github-issue-resolver

add-steamos-support

fix-darwin-uninstaller

flutter-test

ci/freebsd-pkg-bootstrap

cached-serial-check-on-sync

fix-mgmt-cache-bypass-overlay

revert-easyjson-5938

revert-ice-5820

revert-firewalld-5928

refactor/permissions-manager

revert-dns-5935-systemd-resolved

revert-dns-5935-5945

revert-dns-5945-mgmt-cache

feature/log-most-busy-peers

prototype/ui-wails

coderabbitai/utg/8ae8f20

feature/use-peer-fqdn-on-https

release/0.68.3

add-slack-channel

claude/rdp-token-passthrough-eNcqW

transparent-proxy

fix/macos-stale-route-eexist

crowdsec-selfhosted

fix/remove-otel-units

entire/checkpoints/v1

fix/getting-started

feat/static-connectors-combined-server

feature/use-local-keys-embedded

feature/fleetdm

set-env-only-if-not-fork

feature/expose-has-channel

fix/connection-status-race

fix/filter-cgnat-cni-ice-candidates

feature/check-cert-locker-before-acme

test/proxy-fixes

test/proxy-mtu

prototype/ui-tauri

test/proxy-speed

fix-reused-ports

feat/migrate-to-embedded-idp

feature/add-serial-to-proxy-merged

deploy/proxy-serial

test/connection

feature/disable-legacy-port

feature/flag-to-disable-legacy-port

test/perftest

fix/http-redirect

poc-token-command

dn-reverse-proxy

prototype/reverse-proxy-rename

prototype/reverse-proxy-logs-pagination

feature/client-metrics

prototype/reverse-proxy-clusters

debug-dns-route

fix/win-dns-batch

add-extra-route-logs

job-stream-notify-disconnection-eof

deploy/secrets-manager

trigger-proxy-update

bug/update-ios-client-code-build-tags

sync-client-netmap-serial

log/conn-disconn

nmap/compaction-deploy

ci-win-test

feature/disk-encryption-check

wasm-debug

swap-dns-prio

fix/dex-config

feature/migrate-auto-groups-to-table

nmap/compaction

dex-nocgo-stub

feature/exclude-terraform-from-rate-limiting

test-freebsd

retries-refactor

coderabbitai/docstrings/b7e98ac

feat/integrate-zitadel

bug/ios-hanging-reconection

zitadel-idp

feat/network-map-serial

refactor/get-account-no-users

feat/auto-upgrade

feature/report-high-pat-id

feature/temporary-access-for-resource

fix/nmap-fwrules

dont-restart-dns

prototype/ui

update-gomobile

go-dns-for-ice

wasm-ldflags

test-ldflags

wasmbuild-test

feature/networks-s2s

vk/compare-nmaps

dbg/bothmaps

reorder-dns-shutdown

fix/relay-reconnection-race

fix/nmap-exitnodes

vk/debug/nmap-both

move-licensed-code

feat/better-daemon-connection-lost-message

feat/auto-update-2

test/timings

refactor/getaccount-raw

tests/nmap-getaccount

refactor/nmap

refactor/nmap-limit-buffer

feature/detect-mac-wakeup

feature/extract-modules

quick-setings

feat/sync-limiter

feature/store-cache-impl

fix-install-version

feature/store-metrics

feature/metrics-on-store

feature/use-gorm-cache

loadtest-signal

unsymmetrical-squash

refactor/reducate-signaling

test/update-reduce

feature/store-cache

feature/remote-debug

cli-ws-proxy-backend-addr

feat/mgmt-map-serial

snyk-fix-d9d0081a4c7f9137bdb59d0d50a141a2

snyk-fix-7415cea5a11acd66753540ca2c598c63

job-yml-update

feature/android-allow-selecting-routes

fix/up-sequence

fix/dns-hash-update

snyk-fix-967adae9863f17f108ce8948d9117b8d

log/getaccount-by-peer

signal-suppressor

dns-exit-node

feature/auto-updates

feature/cache-srv-key

merged-fixes

fix/missed-offers-and-debug

debug-and-fixes

poc-wasm-clean-backend-s2s

test/remote-debug

debug-api

fix/remove-gpo-if-empty

fix/test-freebsd

fix/mysql-setup

fix/remove-logout-btn

handle-existing-domain-user

chore/unify-domain-validation

snyk-fix-c5fafc8a50ce1f29046e25a1fc346185

feat/profile-edit-btn

snyk-fix-a54966211e18d4cf67e5a2757cc006d1

log-short-id

feat/logout-ephemeral

log-checks

batch-wg-ops

nb-interface-default

feat/aws-integration

add/race-test

feature/relay-feature-versioning

fix/systemd-service-logs

poc/preprocessed-map

add-account-onboarding

bind-ipv6

fix/merge-main

logs/peerlogs-addpeer

feature/net-297-network-migration

feature/support-skip-auto-apply-exit-node-routes

set-cmd

set-command-with-cursor

feature/limit-update-channel

stop-using-locking-share

feature/poc-lazy-detection

feature/net-248-removal-of-sync-mutex-locks

test/multiple-peer-logging

preresolve

add-ns-punnycode-support

apply-routes-early

windows-search-domains

fix/connecting-route-filter

feature/management/rest-client/impersonate

debug-local-records

resource-fields-snake-case

test/grpc-rate-limit

traffic-correlation-policy

feature/rest-client-options

feat/events-metrics

feature/buf-cli

test/add-ratelimiter

test/remove-write-lock-on-add-peer

fix/add-peer-semaphore

feature/users-roles-endpoint

mlsmaycon-patch-1

debug-user-role

chore/primary-key-on-networks

feature/update-account-peers-buffer-startup

remove-ubuntu2004-runners

refactor/permissions-no-pat-allowed

ref/logrus-factory

use-conntrack-zone

deploy/permissions-account

feature/lazy-connection-idle

ref/improve-test-cov

restore-pr-3440

test/increase-grpc-timeouts

feat/buffer-account-peers-update

test/networkmapgeneration-changes

feature/base-manager

feature/flow-receiver

chore/benchmark-with-large-runner

refactor/handshake-initiator

client/ui-update-systray-icons

userspace-router

wgwatcher-test

output-if-key-already-exists

fix/relay-reconnection

feature/port-forwarding-client-codecleaning

detached2

test/callbacks-nil-iceconninfo

refactor/optimize-peer-expiration

enable-udp-port-for-docker-template

fix/relay-update

feature/apply-posture-netmap

fix/group-update-existing-resource

conntrack-stats

upgrade-okta-sdk

multi-price

test/conn-stat

set-min-parallel-tests-for-management

dns-interceptor

debug-dns

router-dns

add-static-system-info

debug-0.29.4

debug-0.33.0

account-refactoring

relay/2800_quic

route-get-account-refactoring

test/seed-random-routes

feature/get-account-refactoring

test/reconnect-race-condition

refactor/get-account-usage

feature/add-session-id-to-update-channel

improve-ipv4conn

fix/async-pion-event-handling

debug

add-offload

feature/validate-group-association-debug

fix/limit-conn-for-sqlite

test/engine-iface

test/transaction-for-jwt-sync

fix/engine-stop-in-foreground

feature/add-mysql-support

test-migration

refactor/header-size-values

relay/eliminate-gob

test/signal-dispatcher-with-relay

relay/debug

validate-icon

feature/ipv6-support

use-pre-expanded-peers-map

feature/use-signal-dispatcher

validate/peer-status

add-read-write-times

fix/sync-peer-race

feature/relay-status

netmap

evaluate/network-map-hash

fix/lower-dns-resolve-interval-on-fail

feature/relay

fix/go-mod-version

upgrade-nftables

synology-userspace-mode

fix/use-ip-for-default-routes-on-darwin

fix/proxy_close

enable-release-workflow-on-pr

deploy/peer-performance

feature/permanent-turn

feature/permanent-turn-proxy

deploy/posture-check-sqlite

feature/optimize_sqlite_save

debug-ios-behavior

fix/delete-route-only-after-adding

tshoot/windows-logger

remove-new-routing

refactor/eliminate-repo-dependency

add-arm-to-ci

refactor-demo-account-object

test/abc2

test/abc

send-ssh-rosenpass-config-meta

refactor-demo

ensure-schedule-never-runs-non-positive

feature/peer-validator-groupmgm

feature/peer-validator-fix

fix/include-active-dashboard-users

fix/handle-canceling-schedule

fix/geo-download

debug-google-workspace

yury/resolve-ip-to-location

feature/extend-sysinfo

sqlite-async-peer-status

yury/add-postgresql-store

fix/route

test-build

posture-checks-poc

debug-keycloak-idp

poc/netstack

for-pascal-tmp

peer-logout-management

manual-peer-logout

detached

chore/refactor-management

test/dns-bind

fix/enforce-acl-for-containers

yury/use-sync-map-in-updatechannel

fix/events-key-handling

filter-cache-on-load-account

fix/user-expiration

handle-user-context-cancellation

nb-client-k8s-statefulset

fake-addr

fix/iptables_in_docker

ebpf-debug

update-getting-started-flow-use-postgres

fix/peer_list_notification

feature/device-authentication-with-client-secret

feature/keep_alive

feat-groups-from-jwt

separate_proxy_from_wgconfig

fix/wg_conn

wg_conn_fix

wg_bind_parallel_processing

fix-rollback-get-acls

proxy_cfg_cleanup

performance-improvement-rego

update-lock-log-level

feat-client-side-acl

refactor/move_grpcserver_logic_to_account_manager

feature/event-storage

feature/update-idp-redeeming-invite

feature/api-peer-info

return-groupminimum-setupkey

feature/interface-bind

documentation_enhancement

fix-peer-registration

ssh

users_cache

pass-client-caller

client_caller_type

revert-283-feat-fix-windows-installer

periodic-peer-updates

ebpf

braginini/wasm

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: DYNR/netbird#11257

[GH-ISSUE #5334] Zitadel Migration Tool #11257

Built-in ZITADEL Guide for Legacy Installer

Step 3: Prepare Your Provider

1. Open the Console

2. Open the NETBIRD Project

3. Create a Web Application

4. Enter a Name

5. Select Authorization Code Flow

6. Enter Your Domain

7. Modify the connector.json File

8. Edit AuthToken

7. Modify the `connector.json` File