This is an automated email from the ASF dual-hosted git repository.
nvazquez pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/main by this push:
new 4b8f45e UI: Add option to enable Project field on login to directly
login to project view (#515)
4b8f45e is described below
commit 4b8f45e0f066afd6020be4d0b15a59e4529659c3
Author: Nicolas Vazquez <nicovazque...@gmail.com>
AuthorDate: Thu Jul 24 11:43:05 2025 -0300
UI: Add option to enable Project field on login to directly login to
project view (#515)
---
source/_static/images/ui-login-project-view.png | Bin 0 -> 79725 bytes
source/adminguide/ui.rst | 24 ++++++++++++++++++++++++
2 files changed, 24 insertions(+)
diff --git a/source/_static/images/ui-login-project-view.png
b/source/_static/images/ui-login-project-view.png
new file mode 100644
index 0000000..49299ff
Binary files /dev/null and b/source/_static/images/ui-login-project-view.png
differ
diff --git a/source/adminguide/ui.rst b/source/adminguide/ui.rst
index 68dd202..047d2f8 100644
--- a/source/adminguide/ui.rst
+++ b/source/adminguide/ui.rst
@@ -45,6 +45,10 @@ the default username is password.
Domain -> If you are a root User, leave this field blank.
+.. note::
+
+ Since 4.21 it is possible to login to a specific Project view by enabling
the 'displayProjectFieldOnLogin' setting on config.json (which is disabled by
default). Please refer to: :ref:`enable-login-to-project-view`.
+
If you are a User in the sub-domains, enter the full path to the domain,
excluding the root domain.
@@ -660,6 +664,23 @@ For the UI to work with different servers, it is necessary
to configure the Ngin
|ui-multiple-server-management.png|
+.. _enable-login-to-project-view:
+
+Enable Login to Project View
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+User can use the file /etc/cloudstack/management/config.json to enable the
Project field displayed on Login by the setting:
+
+=============================
=================================================================
+Property Description
+=============================
=================================================================
+displayProjectFieldOnLogin Disabled by default. When enabled, login
directly to Project view
+=============================
=================================================================
+
+When the Project field is set and the Project exists, the user is directly
directed to the Project view instead of the Default View.
+
+|ui-login-project-view.png|
+
Known Limitations
~~~~~~~~~~~~~~~~~
@@ -684,3 +705,6 @@ The following features are no longer supported or available
in the UI but are st
.. |ui-multiple-server-management.png| image::
/_static/images/ui-multiple-server-management.png
:alt: Custom plugin shown in UI with navigation
+
+.. |ui-login-project-view.png| image::
/_static/images/ui-login-project-view.png
+ :alt: Enabling the Project field on login
