From 1b607dd44153788e36954318a058288efb203b07 Mon Sep 17 00:00:00 2001 From: Luis Ibarra Date: Thu, 7 May 2026 19:00:59 -0500 Subject: [PATCH] docs: update environment variable documentation for form login behavior - Clarified that setting the variable to `true` disables default username and password login only during initial configuration. - Added instructions for re-enabling form login post-setup using the `appsmithctl enable-form-login` command or through Admin Settings. --- .../setup/environment-variables.md | 4 +++- .../setup/instance-management/appsmithctl.mdx | 18 ++++++++++++++++++ 2 files changed, 21 insertions(+), 1 deletion(-) diff --git a/website/docs/getting-started/setup/environment-variables.md b/website/docs/getting-started/setup/environment-variables.md index 70ef1a532f..df9771b138 100644 --- a/website/docs/getting-started/setup/environment-variables.md +++ b/website/docs/getting-started/setup/environment-variables.md @@ -124,7 +124,9 @@ With Appsmith, you can manage user access and authentication methods in your ins
-Set to `true` to turn off the default username and password login. Useful for administrators who want to enforce Single Sign-On (SSO) or limit authentication methods for added security and control. +Set to `true` to turn off the default username and password login when the instance is first configured. Useful for administrators who want to enforce Single Sign-On (SSO) or limit authentication methods for added security and control. + +Changing this variable after that initial setup does **not** update form login behavior in a running instance. To change form login afterward, use [`appsmithctl enable-form-login`](/getting-started/setup/instance-management/appsmithctl#enable-form-login) (alias `appsmithctl efl`) or toggle **Form Login** under **Admin Settings → User Management**, as described in [User Management](/getting-started/setup/instance-configuration/user-management#authentication).
### Security diff --git a/website/docs/getting-started/setup/instance-management/appsmithctl.mdx b/website/docs/getting-started/setup/instance-management/appsmithctl.mdx index 483edbc510..94246a6edc 100644 --- a/website/docs/getting-started/setup/instance-management/appsmithctl.mdx +++ b/website/docs/getting-started/setup/instance-management/appsmithctl.mdx @@ -111,3 +111,21 @@ For more information about restoring an Appsmith instance, see [Restore Instance For more information about restoring the Appsmith database, see [Restore Database](/getting-started/setup/instance-management/backup-and-restore/restore-database) guide. + +#### `enable-form-login` + +
+Use this when you need to turn **form login** (email and password sign-in) back on for your Appsmith instance. + + ```bash + appsmithctl enable-form-login + ``` + +You can also use the short alias: + + ```bash + appsmithctl efl + ``` + +To change form login from the Admin Settings UI instead, see [User Management](/getting-started/setup/instance-configuration/user-management#authentication). +