Skip to content

Commit

Permalink
Mention Invalid Login error on MINIO_SERVER_URL (#1312)
Browse files Browse the repository at this point in the history
The MinIO Console currently does not warn the user if the MinIO server
is not reachable. MinIO Console will just say "Invalid Login" when the
MINIO_SERVER_URL is not reachable which is misleading in the sense that
will make think most people that the username/password/access key is
incorrect so I think it should be mentioned in the documentation that
Invalid Login could be just due to connectivity between console and
server.

Related to minio/console#3428 and
minio/console#3427

@marktheunissen

---------

Co-authored-by: Ruben Laguna <[email protected]>
Co-authored-by: Ravind Kumar <[email protected]>
  • Loading branch information
3 people authored Sep 23, 2024
1 parent 04ff269 commit 9171ccc
Showing 1 changed file with 6 additions and 3 deletions.
9 changes: 6 additions & 3 deletions source/reference/minio-server/settings/deprecated.rst
Original file line number Diff line number Diff line change
Expand Up @@ -75,14 +75,17 @@ They are listed here for historical reference only.

.. deprecated:: RELEASE.2024-05-10T01-41-38Z

The `fully qualified domain name <https://en.wikipedia.org/wiki/Fully_qualified_domain_name>`__ (FQDN) the MinIO Console uses for connecting to the MinIO Server.
The `fully qualified domain name <https://en.wikipedia.org/wiki/Fully_qualified_domain_name>`__ (FQDN) the MinIO Console uses for connecting to the MinIO Server.

For the Console to function correctly, the MinIO server URL *must* be the FQDN of the host, resolveable, and reachable.

If the specified value does not resolve to the MinIO server, logins via the MinIO Console fail and return a network error after a wait period.
Older versions of the Console may return a generic 'Invalid Login' error instead.
Unset the value *or* address the FQDN resolution issue to allow Console logins to proceed.
This setting may be required if:

- The MinIO Server uses a TLS certificate that does not include the host local IP(s) in the certificate Subject Alternative Name (SAN).

or

- The Console must use a specific hostname to connect or reference the MinIO Server, such as due to a reverse proxy or similar configuration.

0 comments on commit 9171ccc

Please sign in to comment.