diff --git a/docs/documentation/tests/src/test/resources/ignored-links b/docs/documentation/tests/src/test/resources/ignored-links index a0d459af1db4..bd864e36aea5 100644 --- a/docs/documentation/tests/src/test/resources/ignored-links +++ b/docs/documentation/tests/src/test/resources/ignored-links @@ -35,4 +35,6 @@ https://developer.paypal.com/developer/applications https://account.live.com/developers/applications/create https://developer.twitter.com/apps/ https://kubernetes.io/docs/tutorials/stateful-application/basic-stateful-set/#rolling-update -https://stackapps.com/apps/oauth/register \ No newline at end of file +https://stackapps.com/apps/oauth/register +# Remove the following line once KC26 is released +https://www.keycloak.org/server/bootstrap-admin-recovery \ No newline at end of file diff --git a/docs/documentation/upgrading/topics/changes/changes-26_0_0.adoc b/docs/documentation/upgrading/topics/changes/changes-26_0_0.adoc index 64ce09fa7023..195e72933dda 100644 --- a/docs/documentation/upgrading/topics/changes/changes-26_0_0.adoc +++ b/docs/documentation/upgrading/topics/changes/changes-26_0_0.adoc @@ -80,4 +80,4 @@ For more details, see link:{adminguide_link}#_ldap_connection_pool[Configuring t It used to be difficult to regain access to a {project_name} instance when all admin users were locked out. The process required multiple advanced steps, including direct database access and manual changes. In an effort to improve the user experience, {project_name} now provides multiple ways to bootstrap a new admin account, which can be used to recover from such situations. -Consequently, the environment variables `KEYCLOAK_ADMIN` and `KEYCLOAK_ADMIN_PASSWORD` have been deprecated. You should use `KC_BOOTSTRAP_ADMIN_USERNAME` and `KC_BOOTSTRAP_ADMIN_PASSWORD` instead. These are also general options, so they may be specified via the cli or other config sources, for example `--bootstrap-admin-username=admin`. For more information, see the new https://www.keycloak.org/high-availability/bootstap-admin-recovery[Bootstrap admin and recovery] guide. +Consequently, the environment variables `KEYCLOAK_ADMIN` and `KEYCLOAK_ADMIN_PASSWORD` have been deprecated. You should use `KC_BOOTSTRAP_ADMIN_USERNAME` and `KC_BOOTSTRAP_ADMIN_PASSWORD` instead. These are also general options, so they may be specified via the cli or other config sources, for example `--bootstrap-admin-username=admin`. For more information, see the new https://www.keycloak.org/server/bootstap-admin-recovery[Bootstrap admin and recovery] guide. diff --git a/docs/guides/server/bootstrap-admin-recovery.adoc b/docs/guides/server/bootstrap-admin-recovery.adoc index 3600551f1596..2cdf80102f40 100644 --- a/docs/guides/server/bootstrap-admin-recovery.adoc +++ b/docs/guides/server/bootstrap-admin-recovery.adoc @@ -24,7 +24,7 @@ Alternatively, the parameters can be directly specified in the command: This command creates a temporary admin user with the username `tmpadm` and the password `tmpadmpass`. -NOTE: The command can be executed even before the first-ever start of {project_name}. However, this will leave the {project_name} server in a state where the temporary admin account is the only account that exists in the master realm and the default admin will not be created. The initial admin creation happens only when the master realm is created. If the intention is to recover lost admin access, the default admin must exist in the master realm prior to executing the command (see <@links.server id="configuration#create-initial-admin"/>). Additionally, it is strongly recommended to use the dedicated command with the same options that the {project_name} server is started with (e.g., `db` options). +NOTE: The command can be executed even before the first-ever start of {project_name}. However, this will leave the {project_name} server in a state where the temporary admin account is the only account that exists in the master realm and the default admin will not be created. The initial admin creation happens only when the master realm is created. If the intention is to recover lost admin access, the default admin must exist in the master realm prior to executing the command (see <@links.server id="configuration" anchor="create-initial-admin"/>). Additionally, it is strongly recommended to use the dedicated command with the same options that the {project_name} server is started with (e.g., `db` options). == Bootstrapping an admin service account diff --git a/docs/guides/templates/links.adoc b/docs/guides/templates/links.adoc index 833b6fe9006f..bedd01a472d9 100644 --- a/docs/guides/templates/links.adoc +++ b/docs/guides/templates/links.adoc @@ -1,3 +1,3 @@ -<#macro server id>link:{links_server_${id}_url}[{links_server_${id}_name}] -<#macro operator id>link:{links_operator_${id}_url}[{links_operator_${id}_name}] -<#macro ha id>link:{links_high-availability_${id}_url}[{links_high-availability_${id}_name}] \ No newline at end of file +<#macro server id anchor="">link:{links_server_${id}_url}<#if anchor != "">#${anchor}[{links_server_${id}_name}] +<#macro operator id anchor="">link:{links_operator_${id}_url}<#if anchor != "">#${anchor}[{links_operator_${id}_name}] +<#macro ha id anchor="">link:{links_high-availability_${id}_url}<#if anchor != "">#${anchor}[{links_high-availability_${id}_name}]