mirror of
https://github.com/portainer/portainer-docs.git
synced 2026-03-27 04:48:31 +07:00
GITBOOK-22: Categorize the troubleshooting
This commit is contained in:
hannah.cooper
committed by
gitbook-bot
gitbook-bot
parent
d8090503fd
commit
24a8e6b56c
85
SUMMARY.md
85
SUMMARY.md
@@ -324,6 +324,7 @@
|
||||
* [Can I upgrade an environment from Docker Standalone to Docker Swarm?](faqs/upgrading/can-i-upgrade-an-environment-from-docker-standalone-to-docker-swarm.md)
|
||||
* [Can I downgrade from Portainer Business to Portainer CE?](faqs/upgrading/can-i-downgrade-from-portainer-business-to-portainer-ce.md)
|
||||
* [Why do my users no longer have access after upgrading to BE from CE?](faqs/upgrading/why-do-my-users-no-longer-have-access-after-upgrading-to-be-from-ce.md)
|
||||
* [How can I roll back to a previous version of Portainer?](faqs/upgrading/how-can-i-roll-back-to-a-previous-version-of-portainer.md)
|
||||
* [Licensing](faqs/licensing/README.md)
|
||||
* [What is a node for licensing purposes?](faqs/licensing/what-is-a-node-for-licensing-purposes.md)
|
||||
* [How do I add more nodes to my license?](faqs/licensing/how-do-i-add-more-nodes-to-my-license.md)
|
||||
@@ -344,45 +345,51 @@
|
||||
* [How do I renew my 3 nodes free license?](faqs/licensing/how-do-i-renew-my-3-nodes-free-license.md)
|
||||
* [How do I renew my 5 nodes free license?](faqs/licensing/how-do-i-renew-my-5-nodes-free-license.md)
|
||||
* [Troubleshooting](faqs/troubleshooting/README.md)
|
||||
* [Why can't I use the console with my container?](faqs/troubleshooting/why-cant-i-use-the-console-with-my-container.md)
|
||||
* [How can I move existing Edge Agent deployments to a new Portainer Server instance?](faqs/troubleshooting/how-can-i-move-existing-edge-agent-deployments-to-a-new-portainer-server-instance.md)
|
||||
* [Why is my node count higher than it should be?](faqs/troubleshooting/why-is-my-node-count-higher-than-it-should-be.md)
|
||||
* [How do automatic updates for stacks/applications work?](faqs/troubleshooting/how-do-automatic-updates-for-stacks-applications-work.md)
|
||||
* [How does the image update notification icon work?](faqs/troubleshooting/how-does-the-image-update-notification-icon-work.md)
|
||||
* [Can I build an image while deploying a stack/application from Git?](faqs/troubleshooting/can-i-build-an-image-while-deploying-a-stack-application-from-git.md)
|
||||
* [Why can't my agents communicate with Portainer on Swarm?](faqs/troubleshooting/why-cant-my-agents-communicate-with-portainer-on-swarm.md)
|
||||
* [Why don't custom standalone app templates show when using Docker Swarm?](faqs/troubleshooting/why-dont-custom-standalone-app-templates-show-when-using-docker-swarm.md)
|
||||
* [Can you view deleted container logs in Portainer?](faqs/troubleshooting/can-you-view-deleted-container-logs-in-portainer.md)
|
||||
* [I enabled "Force HTTPS only" and now I'm locked out of Portainer. How do I get back in?](faqs/troubleshooting/i-enabled-force-https-only-and-now-im-locked-out-of-portainer.-how-do-i-get-back-in.md)
|
||||
* [Exposed ports in the container view redirect me to 0.0.0.0. What can I do?](faqs/troubleshooting/exposed-ports-in-the-container-view-redirect-me-to-0.0.0.0.-what-can-i-do.md)
|
||||
* [How can I switch back to internal authentication?](faqs/troubleshooting/how-can-i-switch-back-to-internal-authentication.md)
|
||||
* [How do I reset my Portainer password?](faqs/troubleshooting/how-do-i-reset-my-portainer-password.md)
|
||||
* [How can I get the logs for Portainer itself?](faqs/troubleshooting/how-can-i-get-the-logs-for-portainer-itself.md)
|
||||
* [Why can't my users see anything in the environment they have access to?](faqs/troubleshooting/why-cant-my-users-see-anything-in-the-environment-they-have-access-to.md)
|
||||
* [How do I configure Portainer's GitOps features to authenticate to a Bitbucket repository?](faqs/troubleshooting/how-do-i-configure-portainers-gitops-features-to-authenticate-to-a-bitbucket-repository.md)
|
||||
* [Why is a feature only available in Portainer Business Edition?](faqs/troubleshooting/why-is-a-feature-only-available-in-portainer-business-edition.md)
|
||||
* [Client sent an HTTP request to an HTTPS server](faqs/troubleshooting/client-sent-an-http-request-to-an-https-server.md)
|
||||
* [Runtime and Resource sliders are not showing the set value on ARM](faqs/troubleshooting/runtime-and-resource-sliders-are-not-showing-the-set-value-on-arm.md)
|
||||
* [Why do I see a lot of TLS handshake errors in my Portainer and/or Agent logs?](faqs/troubleshooting/why-do-i-see-a-lot-of-tls-handshake-errors-in-my-portainer-and-or-agent-logs.md)
|
||||
* ["Failed to get license info" or "Unable to retrieve license info" message with valid license](faqs/troubleshooting/failed-to-get-license-info-or-unable-to-retrieve-license-info-message-with-valid-license.md)
|
||||
* [Why has my Environment IP not updated after I changed it?](faqs/troubleshooting/why-has-my-environment-ip-not-updated-after-i-changed-it.md)
|
||||
* [How to enable/disable image Up-to-date indicator](faqs/troubleshooting/how-to-enable-disable-image-up-to-date-indicator.md)
|
||||
* [I am unable to push an image to an AWS Elastic Container Registry](faqs/troubleshooting/i-am-unable-to-push-an-image-to-an-aws-elastic-container-registry.md)
|
||||
* [Why are stack deployment times slow?](faqs/troubleshooting/why-are-stack-deployment-times-slow.md)
|
||||
* [What does a 500 error code mean?](faqs/troubleshooting/what-does-a-500-error-code-mean.md)
|
||||
* [Why is my console closing after a certain time?](faqs/troubleshooting/why-is-my-console-closing-after-a-certain-time.md)
|
||||
* [How can I use my custom certificate authority (CA) with Portainer?](faqs/troubleshooting/how-can-i-use-my-custom-certificate-authority-ca-with-portainer.md)
|
||||
* [Troubleshooting Edge Agent Connection Issues](faqs/troubleshooting/troubleshooting-edge-agent-connection-issues.md)
|
||||
* [How can I roll back to a previous version of Portainer?](faqs/troubleshooting/how-can-i-roll-back-to-a-previous-version-of-portainer.md)
|
||||
* [Unable to Access Pod Logs in My k0s Cluster](faqs/troubleshooting/unable-to-access-pod-logs-in-my-k0s-cluster.md)
|
||||
* [Unable to Login via LDAP in Portainer](faqs/troubleshooting/unable-to-login-via-ldap-in-portainer.md)
|
||||
* [Environment Variable Management in Docker: .env vs. stack.env](faqs/troubleshooting/environment-variable-management-in-docker-.env-vs.-stack.env.md)
|
||||
* [Why is my Portainer Edge Agent using a large amount of memory](faqs/troubleshooting/why-is-my-portainer-edge-agent-using-a-large-amount-of-memory.md)
|
||||
* [“Failed logging user activity” error in Portainer](faqs/troubleshooting/failed-logging-user-activity-error-in-portainer.md)
|
||||
* [Unable to Authenticate After Portainer Update](faqs/troubleshooting/unable-to-authenticate-after-portainer-update.md)
|
||||
* [How do I recover orphaned stacks from a previously deleted environment?](faqs/troubleshooting/how-do-i-recover-orphaned-stacks-from-a-previously-deleted-environment.md)
|
||||
* [How do I change the way I connect to an environment without losing my existing stacks?](faqs/troubleshooting/how-do-i-change-the-way-i-connect-to-an-environment-without-losing-my-existing-stacks.md)
|
||||
* [Why doesn’t the Portainer UI load inside an iframe?](faqs/troubleshooting/why-doesnt-the-portainer-ui-load-inside-an-iframe.md)
|
||||
* [Access and authentication](faqs/troubleshooting/access-and-authentication/README.md)
|
||||
* [How can I switch back to internal authentication?](faqs/troubleshooting/access-and-authentication/how-can-i-switch-back-to-internal-authentication.md)
|
||||
* [I enabled "Force HTTPS only" and now I'm locked out of Portainer. How do I get back in?](faqs/troubleshooting/access-and-authentication/i-enabled-force-https-only-and-now-im-locked-out-of-portainer.-how-do-i-get-back-in.md)
|
||||
* [How do I reset my Portainer password?](faqs/troubleshooting/access-and-authentication/how-do-i-reset-my-portainer-password.md)
|
||||
* [Client sent an HTTP request to an HTTPS server](faqs/troubleshooting/access-and-authentication/client-sent-an-http-request-to-an-https-server.md)
|
||||
* [Unable to Authenticate After Portainer Update](faqs/troubleshooting/access-and-authentication/unable-to-authenticate-after-portainer-update.md)
|
||||
* [Unable to Login via LDAP in Portainer](faqs/troubleshooting/access-and-authentication/unable-to-login-via-ldap-in-portainer.md)
|
||||
* [Agents and environment management](faqs/troubleshooting/agents-and-environment-management/README.md)
|
||||
* [How can I move existing Edge Agent deployments to a new Portainer Server instance?](faqs/troubleshooting/agents-and-environment-management/how-can-i-move-existing-edge-agent-deployments-to-a-new-portainer-server-instance.md)
|
||||
* [Why can't my agents communicate with Portainer on Swarm?](faqs/troubleshooting/agents-and-environment-management/why-cant-my-agents-communicate-with-portainer-on-swarm.md)
|
||||
* [Why has my Environment IP not updated after I changed it?](faqs/troubleshooting/agents-and-environment-management/why-has-my-environment-ip-not-updated-after-i-changed-it.md)
|
||||
* [Why is my Portainer Edge Agent using a large amount of memory?](faqs/troubleshooting/agents-and-environment-management/why-is-my-portainer-edge-agent-using-a-large-amount-of-memory.md)
|
||||
* [Troubleshooting Edge Agent Connection Issues](faqs/troubleshooting/agents-and-environment-management/troubleshooting-edge-agent-connection-issues.md)
|
||||
* [How do I change the way I connect to an environment without losing my existing stacks?](faqs/troubleshooting/agents-and-environment-management/how-do-i-change-the-way-i-connect-to-an-environment-without-losing-my-existing-stacks.md)
|
||||
* [Stacks, deployments and updates](faqs/troubleshooting/stacks-deployments-and-updates/README.md)
|
||||
* [How do automatic updates for stacks/applications work?](faqs/troubleshooting/stacks-deployments-and-updates/how-do-automatic-updates-for-stacks-applications-work.md)
|
||||
* [How does the image update notification icon work?](faqs/troubleshooting/stacks-deployments-and-updates/how-does-the-image-update-notification-icon-work.md)
|
||||
* [Can I build an image while deploying a stack/application from Git?](faqs/troubleshooting/stacks-deployments-and-updates/can-i-build-an-image-while-deploying-a-stack-application-from-git.md)
|
||||
* [Why don't custom standalone app templates show when using Docker Swarm?](faqs/troubleshooting/stacks-deployments-and-updates/why-dont-custom-standalone-app-templates-show-when-using-docker-swarm.md)
|
||||
* [How do I configure Portainer's GitOps features to authenticate to a Bitbucket repository?](faqs/troubleshooting/stacks-deployments-and-updates/how-do-i-configure-portainers-gitops-features-to-authenticate-to-a-bitbucket-repository.md)
|
||||
* [Why are stack deployment times slow?](faqs/troubleshooting/stacks-deployments-and-updates/why-are-stack-deployment-times-slow.md)
|
||||
* [Environment Variable Management in Docker: .env vs. stack.env](faqs/troubleshooting/stacks-deployments-and-updates/environment-variable-management-in-docker-.env-vs.-stack.env.md)
|
||||
* [How do I recover orphaned stacks from a previously deleted environment?](faqs/troubleshooting/stacks-deployments-and-updates/how-do-i-recover-orphaned-stacks-from-a-previously-deleted-environment.md)
|
||||
* [UI and features](faqs/troubleshooting/ui-and-features/README.md)
|
||||
* [Why can't I use the console with my container?](faqs/troubleshooting/ui-and-features/why-cant-i-use-the-console-with-my-container.md)
|
||||
* [Exposed ports in the container view redirect me to 0.0.0.0. What can I do?](faqs/troubleshooting/ui-and-features/exposed-ports-in-the-container-view-redirect-me-to-0.0.0.0.-what-can-i-do.md)
|
||||
* [Why is a feature only available in Portainer Business Edition?](faqs/troubleshooting/ui-and-features/why-is-a-feature-only-available-in-portainer-business-edition.md)
|
||||
* [Runtime and Resource sliders are not showing the set value on ARM](faqs/troubleshooting/ui-and-features/runtime-and-resource-sliders-are-not-showing-the-set-value-on-arm.md)
|
||||
* [Why doesn’t the Portainer UI load inside an iframe?](faqs/troubleshooting/ui-and-features/why-doesnt-the-portainer-ui-load-inside-an-iframe.md)
|
||||
* [Logs, errors and debugging](faqs/troubleshooting/logs-errors-and-debugging/README.md)
|
||||
* [Unable to Access Pod Logs in My k0s Cluster](faqs/troubleshooting/logs-errors-and-debugging/unable-to-access-pod-logs-in-my-k0s-cluster.md)
|
||||
* [Can you view deleted container logs in Portainer?](faqs/troubleshooting/logs-errors-and-debugging/can-you-view-deleted-container-logs-in-portainer.md)
|
||||
* [How can I get the logs for Portainer itself?](faqs/troubleshooting/logs-errors-and-debugging/how-can-i-get-the-logs-for-portainer-itself.md)
|
||||
* [Why can't my users see anything in the environment they have access to?](faqs/troubleshooting/logs-errors-and-debugging/why-cant-my-users-see-anything-in-the-environment-they-have-access-to.md)
|
||||
* [Why do I see a lot of TLS handshake errors in my Portainer and/or Agent logs?](faqs/troubleshooting/logs-errors-and-debugging/why-do-i-see-a-lot-of-tls-handshake-errors-in-my-portainer-and-or-agent-logs.md)
|
||||
* ["Failed to get license info" or "Unable to retrieve license info" message with valid license](faqs/troubleshooting/logs-errors-and-debugging/failed-to-get-license-info-or-unable-to-retrieve-license-info-message-with-valid-license.md)
|
||||
* [What does a 500 error code mean?](faqs/troubleshooting/logs-errors-and-debugging/what-does-a-500-error-code-mean.md)
|
||||
* [Why is my console closing after a certain time?](faqs/troubleshooting/logs-errors-and-debugging/why-is-my-console-closing-after-a-certain-time.md)
|
||||
* [“Failed logging user activity” error in Portainer](faqs/troubleshooting/logs-errors-and-debugging/failed-logging-user-activity-error-in-portainer.md)
|
||||
* [Certificates and security](faqs/troubleshooting/certificates-and-security/README.md)
|
||||
* [How to enable/disable image Up-to-date indicator](faqs/troubleshooting/certificates-and-security/how-to-enable-disable-image-up-to-date-indicator.md)
|
||||
* [How can I use my custom certificate authority (CA) with Portainer?](faqs/troubleshooting/certificates-and-security/how-can-i-use-my-custom-certificate-authority-ca-with-portainer.md)
|
||||
* [Registry and image management](faqs/troubleshooting/registry-and-image-management/README.md)
|
||||
* [Why is my node count higher than it should be?](faqs/troubleshooting/registry-and-image-management/why-is-my-node-count-higher-than-it-should-be.md)
|
||||
* [I am unable to push an image to an AWS Elastic Container Registry](faqs/troubleshooting/registry-and-image-management/i-am-unable-to-push-an-image-to-an-aws-elastic-container-registry.md)
|
||||
* [Contributing](faqs/contributing/README.md)
|
||||
* [How do I report a bug?](faqs/contributing/how-do-i-report-a-bug.md)
|
||||
* [How do I raise a feature request?](faqs/contributing/how-do-i-raise-a-feature-request.md)
|
||||
|
||||
@@ -4,4 +4,4 @@ With Portainer you can choose whether to use the built-in authentication system
|
||||
|
||||
The exception to this is the initial admin user that was created when you first installed Portainer. This user is able to log in using internal authentication when an external authentication provider is enabled, and is intended as an emergency "break glass" method of accessing Portainer if you have issues with your external authentication provider or configuration. No other internal users, even those that are admins, will be able to log in using internal authentication when an external authentication provider is enabled.
|
||||
|
||||
When configuring an external authentication provider within Portainer, you can enable the **Hide internal authentication prompt** option to hide the internal authentication option from the login page. If you have done this and find yourself locked out, refer to [this knowledge base article](../troubleshooting/how-can-i-switch-back-to-internal-authentication.md).
|
||||
When configuring an external authentication provider within Portainer, you can enable the **Hide internal authentication prompt** option to hide the internal authentication option from the login page. If you have done this and find yourself locked out, refer to [this knowledge base article](../troubleshooting/access-and-authentication/how-can-i-switch-back-to-internal-authentication.md).
|
||||
|
||||
@@ -6,42 +6,3 @@ description: >-
|
||||
|
||||
# Troubleshooting
|
||||
|
||||
* [Why can't I use the console with my container?](why-cant-i-use-the-console-with-my-container.md)
|
||||
* [How can I move existing Edge Agent deployments to a new Portainer Server instance?](how-can-i-move-existing-edge-agent-deployments-to-a-new-portainer-server-instance.md)
|
||||
* [Why is my node count higher than it should be?](why-is-my-node-count-higher-than-it-should-be.md)
|
||||
* [How do automatic updates for stacks/applications work?](how-do-automatic-updates-for-stacks-applications-work.md)
|
||||
* [How does the image update notification icon work?](how-does-the-image-update-notification-icon-work.md)
|
||||
* [Can I build an image while deploying a stack/application from Git?](can-i-build-an-image-while-deploying-a-stack-application-from-git.md)
|
||||
* [Why can't my agents communicate with Portainer on Swarm?](why-cant-my-agents-communicate-with-portainer-on-swarm.md)
|
||||
* [Why don't custom standalone app templates show when using Docker Swarm?](why-dont-custom-standalone-app-templates-show-when-using-docker-swarm.md)
|
||||
* [Can you view deleted container logs in Portainer?](can-you-view-deleted-container-logs-in-portainer.md)
|
||||
* [I enabled "Force HTTPS only" and now I'm locked out of Portainer. How do I get back in?](i-enabled-force-https-only-and-now-im-locked-out-of-portainer.-how-do-i-get-back-in.md)
|
||||
* [Exposed ports in the container view redirect me to 0.0.0.0. What can I do?](exposed-ports-in-the-container-view-redirect-me-to-0.0.0.0.-what-can-i-do.md)
|
||||
* [How can I switch back to internal authentication?](how-can-i-switch-back-to-internal-authentication.md)
|
||||
* [How do I reset my Portainer password?](how-do-i-reset-my-portainer-password.md)
|
||||
* [How can I get the logs for Portainer itself?](how-can-i-get-the-logs-for-portainer-itself.md)
|
||||
* [Why can't my users see anything in the environment they have access to?](why-cant-my-users-see-anything-in-the-environment-they-have-access-to.md)
|
||||
* [How do I configure Portainer's GitOps features to authenticate to a Bitbucket repository?](how-do-i-configure-portainers-gitops-features-to-authenticate-to-a-bitbucket-repository.md)
|
||||
* [Why is a feature only available in Portainer Business Edition?](why-is-a-feature-only-available-in-portainer-business-edition.md)
|
||||
* [Client sent an HTTP request to an HTTPS server](client-sent-an-http-request-to-an-https-server.md)
|
||||
* [Runtime and Resource sliders are not showing the set value on ARM](runtime-and-resource-sliders-are-not-showing-the-set-value-on-arm.md)
|
||||
* [Why do I see a lot of TLS handshake errors in my Portainer and/or Agent logs?](why-do-i-see-a-lot-of-tls-handshake-errors-in-my-portainer-and-or-agent-logs.md)
|
||||
* [My license is valid but I get "Failed to get license info" or "Unable to retrieve license info" messages. How can I fix this?](failed-to-get-license-info-or-unable-to-retrieve-license-info-message-with-valid-license.md)
|
||||
* [Why has my Environment IP not updated after I changed it?](why-has-my-environment-ip-not-updated-after-i-changed-it.md)
|
||||
* [How to enable/disable image Up-to-date indicator](how-to-enable-disable-image-up-to-date-indicator.md)
|
||||
* [I am unable to push an image to an AWS Elastic Container Registry](i-am-unable-to-push-an-image-to-an-aws-elastic-container-registry.md)
|
||||
* [Why are stack deployment times slow?](why-are-stack-deployment-times-slow.md)
|
||||
* [What does a 500 error code mean?](what-does-a-500-error-code-mean.md)
|
||||
* [Why is my console closing after a certain time?](why-is-my-console-closing-after-a-certain-time.md)
|
||||
* [How can I use my custom certificate authority (CA) with Portainer?](how-can-i-use-my-custom-certificate-authority-ca-with-portainer.md)
|
||||
* [Troubleshooting Edge Agent Connection Issues](troubleshooting-edge-agent-connection-issues.md)
|
||||
* [How can I roll back to a previous version of Portainer?](how-can-i-roll-back-to-a-previous-version-of-portainer.md)
|
||||
* [Unable to Access Pod Logs in My k0s Cluster](unable-to-access-pod-logs-in-my-k0s-cluster.md)
|
||||
* [Unable to Login via LDAP in Portainer](unable-to-login-via-ldap-in-portainer.md)
|
||||
* [Environment Variable Management in Docker: .env vs. stack.env](environment-variable-management-in-docker-.env-vs.-stack.env.md)
|
||||
* [Why is my Portainer Edge Agent using a large amount of memory](why-is-my-portainer-edge-agent-using-a-large-amount-of-memory.md)
|
||||
* [“Failed logging user activity” Error in Portainer](failed-logging-user-activity-error-in-portainer.md)
|
||||
* [Unable to Authenticate After Portainer Update](unable-to-authenticate-after-portainer-update.md)
|
||||
* [How do I recover orphaned stacks from a previously deleted environment?](how-do-i-recover-orphaned-stacks-from-a-previously-deleted-environment.md)
|
||||
* [How do I change the way I connect to an environment without losing my existing stacks?](how-do-i-change-the-way-i-connect-to-an-environment-without-losing-my-existing-stacks.md)
|
||||
* [Why doesn’t the Portainer UI load inside an iframe?](why-doesnt-the-portainer-ui-load-inside-an-iframe.md)
|
||||
|
||||
2
faqs/troubleshooting/access-and-authentication/README.md
Normal file
2
faqs/troubleshooting/access-and-authentication/README.md
Normal file
@@ -0,0 +1,2 @@
|
||||
# Access and authentication
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# How can I switch back to internal authentication?
|
||||
|
||||
If you are able to log into Portainer as an administrator you can change your authentication method under Settings, [Authentication](../../admin/settings/authentication/) and selecting Internal.
|
||||
If you are able to log into Portainer as an administrator you can change your authentication method under Settings, [Authentication](../../../admin/settings/authentication/) and selecting Internal.
|
||||
|
||||
If you are unable to log into Portainer (for example if you have been locked out due to a external authentication / SSO misconfiguration) you can force using internal authentication by going to:
|
||||
|
||||
@@ -10,4 +10,4 @@ https://localhost:9443/#!/internal-auth
|
||||
|
||||
Replace https://localhost:9443 with the URL and port of your Portainer server. You can then log in as the initial administrator user you first set up when installing Portainer.
|
||||
|
||||
If you don't have the password for the initial administrator user, you can use our [password reset helper.](../../advanced/reset-admin.md)
|
||||
If you don't have the password for the initial administrator user, you can use our [password reset helper.](../../../advanced/reset-admin.md)
|
||||
@@ -2,4 +2,4 @@
|
||||
|
||||
If you know your current password and can log into Portainer, you can set a new password via the Portainer UI.
|
||||
|
||||
If you have forgotten your password or are unable to log in, either ask another Portainer admin to reset the password for you, or use our [password reset helper ](../../advanced/reset-admin.md)to reset the default admin account password (from when Portainer was initialized).
|
||||
If you have forgotten your password or are unable to log in, either ask another Portainer admin to reset the password for you, or use our [password reset helper ](../../../advanced/reset-admin.md)to reset the default admin account password (from when Portainer was initialized).
|
||||
@@ -1,6 +1,6 @@
|
||||
# I enabled "Force HTTPS only" and now I'm locked out of Portainer. How do I get back in?
|
||||
|
||||
Enabling the **Force HTTPS only** option (either via the toggle in [Settings](../../admin/settings/) or via the --http-disabled command line option) disables logging into Portainer via HTTP. If your HTTPS setup is misconfigured (for example a malformed or missing certificate chain) this can result in you being locked out of Portainer.
|
||||
Enabling the **Force HTTPS only** option (either via the toggle in [Settings](../../../admin/settings/) or via the --http-disabled command line option) disables logging into Portainer via HTTP. If your HTTPS setup is misconfigured (for example a malformed or missing certificate chain) this can result in you being locked out of Portainer.
|
||||
|
||||
To resolve this, you can re-enable HTTP access by using the --http-enabled command line option in your docker run command, for example:
|
||||
|
||||
@@ -0,0 +1,2 @@
|
||||
# Agents and environment management
|
||||
|
||||
@@ -4,7 +4,7 @@ In order to change the Portainer server URL for an Edge Agent, a redeployment of
|
||||
|
||||
When deploying an Edge Agent, the Portainer server URL is encrypted into the Edge key. This tells the Edge Agent where to look for the Portainer server.
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (8).png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../../../.gitbook/assets/image (8).png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
The most typical scenarios that require a change to the Portainer server URL are:
|
||||
|
||||
@@ -12,13 +12,13 @@ In the case of changing the way you connect to an environment (for example by mo
|
||||
|
||||
Under **Administration**, navigate to **Environment-related**, then to **Environments**. Select the environment you would like to remove and click **Remove.** The stacks in this environment will become orphaned, and therefore available to be re-associated once you re-add the environment in the next step.
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (38).png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../../../.gitbook/assets/image (38).png" alt=""><figcaption></figcaption></figure>
|
||||
{% endstep %}
|
||||
|
||||
{% step %}
|
||||
### Adding a new environment using the new connection method
|
||||
|
||||
[Add the environment again](../../admin/environments/add/) using the new connection method.
|
||||
[Add the environment again](../../../admin/environments/add/) using the new connection method.
|
||||
{% endstep %}
|
||||
|
||||
{% step %}
|
||||
@@ -26,11 +26,11 @@ Under **Administration**, navigate to **Environment-related**, then to **Environ
|
||||
|
||||
Within the environment that you want to associate your orphaned stacks with, click **Stacks** in the left hand menu. At the Stacks list, click on the three dots in the top right corner and select **Show all orphaned stacks**. Your stack list will then update to include any orphaned stacks.
|
||||
|
||||
<div align="left"><figure><img src="../../.gitbook/assets/image (39).png" alt=""><figcaption></figcaption></figure></div>
|
||||
<div align="left"><figure><img src="../../../.gitbook/assets/image (39).png" alt=""><figcaption></figcaption></figure></div>
|
||||
|
||||
Click into the stack that you want to recover, and select **Associate.**
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (40).png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../../../.gitbook/assets/image (40).png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
Your stack will now appear in your stack list with total control. Repeat this process for each stack you want to re-associate. 
|
||||
{% endstep %}
|
||||
@@ -5,7 +5,7 @@
|
||||
Check your **Portainer Edge Compute Settings** by navigating to **Settings** > **Edge Compute** > **Edge Compute Settings**. \
|
||||
  \- Confirm that the **Portainer API Server URL** and the **Portainer Tunnel Address** are correct.\
|
||||
  \- Ensure that ports **9443** and **8000** are open in your firewall.\
|
||||
  \- Refer to the official Portainer documentation for detailed agent setup [requirements](../../advanced/edge-agent.md)
|
||||
  \- Refer to the official Portainer documentation for detailed agent setup [requirements](../../../advanced/edge-agent.md)
|
||||
|
||||
***
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
If you have updated your Portainer Agent environment's IP address, you may not see the update apply correctly in your Portainer Server instance. To resolve this, restart your Portainer Server container.
|
||||
|
||||
Assuming you have followed our [install instructions](../../start/install/server/), you can do this from the command line:
|
||||
Assuming you have followed our [install instructions](../../../start/install/server/), you can do this from the command line:
|
||||
|
||||
On Docker Standalone:
|
||||
|
||||
2
faqs/troubleshooting/certificates-and-security/README.md
Normal file
2
faqs/troubleshooting/certificates-and-security/README.md
Normal file
@@ -0,0 +1,2 @@
|
||||
# Certificates and security
|
||||
|
||||
2
faqs/troubleshooting/logs-errors-and-debugging/README.md
Normal file
2
faqs/troubleshooting/logs-errors-and-debugging/README.md
Normal file
@@ -0,0 +1,2 @@
|
||||
# Logs, errors and debugging
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# How can I get the logs for Portainer itself?
|
||||
|
||||
Portainer runs as a container, so you can view the Portainer logs in the same way you would do for any other container. You can view the logs [through the Portainer UI](../../user/docker/containers/logs.md), or alternatively if you have access to the host you can use the Docker CLI:
|
||||
Portainer runs as a container, so you can view the Portainer logs in the same way you would do for any other container. You can view the logs [through the Portainer UI](../../../user/docker/containers/logs.md), or alternatively if you have access to the host you can use the Docker CLI:
|
||||
|
||||
Log into the command line of a Docker manager node (for Swarm) or the Docker host (for Standalone) and run the following command:
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
You have set up a multi-control-plane node Kubernetes cluster using k0s and have successfully deployed the Portainer agent to the cluster. Portainer can connect to the Kubernetes cluster; however, you may encounter errors when accessing logs—sometimes intermittently. You might see an error message toast similar to the following when attempting to view the logs.\
|
||||
`Unable to get pod logs: Get “https://<IP>:10250/… : No agent available`
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (19).png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../../../.gitbook/assets/image (19).png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
Based on our testing, the likely cause of this issue is the absence of node-local load balancing in a k0s-based Kubernetes cluster with multiple control-plane nodes. For more details, refer to the [Configuration file reference](https://docs.k0sproject.io/stable/k0sctl-install/) in the Mirantis, Inc. Configuration Options documentation.
|
||||
|
||||
@@ -2,5 +2,5 @@
|
||||
|
||||
For security reasons, all resources inside an environment are assigned only to the administrator by default. To give non-admin users access, you can either:
|
||||
|
||||
* Use the [access control tool](../../advanced/access-control.md) within each resource to assign ownership to users.
|
||||
* Use the [access control tool](../../../advanced/access-control.md) within each resource to assign ownership to users.
|
||||
* Make the resource public, so all users get access to it.
|
||||
@@ -19,7 +19,7 @@ proxy_read_timeout 3600;
|
||||
Edit the proxy host that you need to change and add `proxy_read_timeout 3600;` as below.\
|
||||
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (18).png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../../../.gitbook/assets/image (18).png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
**Nginx Ingress Controller (Kubernetes)**\
|
||||
\
|
||||
@@ -0,0 +1,2 @@
|
||||
# Registry and image management
|
||||
|
||||
@@ -4,4 +4,4 @@ AWS Elastic Container Registry [requires users to pre-create all repositories](h
|
||||
|
||||
If the AWS Elastic Container Registry does not have a repository created, the user will receive the following error message while attempting to push an image in Portainer:
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (17).png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../../../.gitbook/assets/image (17).png" alt=""><figcaption></figcaption></figure>
|
||||
@@ -12,23 +12,23 @@ Even knowing this, it is possible to create situations where your node count, an
|
||||
|
||||
For example, if Portainer is managing a swarm consisting of one manager and three workers, **4** licenses are used.
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (9).png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../../../.gitbook/assets/image (9).png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (10).png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../../../.gitbook/assets/image (10).png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
This Portainer environment consists of the manager and all three worker nodes. There is no need to add anything else to Portainer in order to manager this entire cluster. The Portainer Agent is deployed to come up on every worker node, so when new workers come online, an instance of the Agent will be scheduled on them automatically and an additional license will be used.
|
||||
|
||||
If you mistakenly add one of the workers as a **new** environment in Portainer, Portainer will gladly talk to it, see that it is a cluster consisting of four nodes, and apply licensing accordingly.
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (11).png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../../../.gitbook/assets/image (11).png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (12).png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../../../.gitbook/assets/image (12).png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
As you can see, now that the worker has been added as another cluster, Portainer counts the nodes in the cluster and applies a license for each of them. This uses **8** licenses where only **4** licenses were needed. If this approach were to continue for all of the workers, **16** license would be used for a four node cluster.
|
||||
|
||||
If you find yourself in this situation, you can simply remove the extraneously added environments by clicking **Environments** in the navigation menu, then selecting the environment to be removed, and clicking the **Remove** button.
|
||||
|
||||
<figure><img src="../../.gitbook/assets/remove-environment-png.png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../../../.gitbook/assets/remove-environment-png.png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
\
|
||||
This will not affect the workloads running on the worker or the cluster. It will simply remove it from being seen by Portainer as a unique environment and adjust your licensing count appropriately.
|
||||
@@ -0,0 +1,2 @@
|
||||
# Stacks, deployments and updates
|
||||
|
||||
@@ -2,4 +2,4 @@
|
||||
|
||||
Our Git repository support is in its first version currently, so it is not fully-featured. One of the elements that are currently not fully implemented is building images via docker-compose, particularly around building from files that are included in the repository. We hope to expand the capability of this in the future.
|
||||
|
||||
If the image is [built separately](../../user/docker/images/build.md) and referenced from docker-compose, it should install without an issue.
|
||||
If the image is [built separately](../../../user/docker/images/build.md) and referenced from docker-compose, it should install without an issue.
|
||||
@@ -81,7 +81,7 @@ Since `stack.env` does not support variable substitution, you can use webhooks o
|
||||
|
||||
### **Additional Resources**
|
||||
|
||||
* [**Portainer Webhook Documentation**](../../user/docker/stacks/webhooks.md): For more detailed instructions on using webhooks with Docker Swarm, refer to the official documentation.
|
||||
* [**Portainer Webhook Documentation**](../../../user/docker/stacks/webhooks.md): For more detailed instructions on using webhooks with Docker Swarm, refer to the official documentation.
|
||||
|
||||
***
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# How do automatic updates for stacks/applications work?
|
||||
|
||||
When you configure automatic updates for a [stack](../../user/docker/stacks/) or [application](../../user/kubernetes/applications/manifest.md) deployed from a Git repository, you can choose for Portainer to either poll the Git repository for updates on a defined interval, or use a webhook to trigger a check on-demand (generally as part of an automated process). Regardless of the method you choose, the following events occur when a check is performed:
|
||||
When you configure automatic updates for a [stack](../../../user/docker/stacks/) or [application](../../../user/kubernetes/applications/manifest.md) deployed from a Git repository, you can choose for Portainer to either poll the Git repository for updates on a defined interval, or use a webhook to trigger a check on-demand (generally as part of an automated process). Regardless of the method you choose, the following events occur when a check is performed:
|
||||
|
||||
* Portainer connects to the remote Git repository and retrieves the hash of the latest commit.
|
||||
* If the latest commit hash matches the hash that Portainer has in its database for the stack/application, Portainer assumes that the stack/application is up to date, and no further action is taken. 
|
||||
@@ -4,10 +4,10 @@ Stacks from an environment that has been deleted will be labelled as orphaned st
|
||||
|
||||
1. Within the environment that you want to associate your orphaned stacks with, click **Stacks** in the left hand menu. At the Stacks list, click on the three dots in the top right corner and select **Show all orphaned stacks**. Your stack list will then update to include any orphaned stacks.
|
||||
|
||||
<div align="left"><figure><img src="../../.gitbook/assets/image.png" alt=""><figcaption></figcaption></figure></div>
|
||||
<div align="left"><figure><img src="../../../.gitbook/assets/image.png" alt=""><figcaption></figcaption></figure></div>
|
||||
|
||||
1. Click into the stack that you want to recover, and select **Associate.**
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (1).png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../../../.gitbook/assets/image (1).png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
Your stack will now appear in your stack list with total control. Repeat this process for each stack you want to reassociate.
|
||||
2
faqs/troubleshooting/ui-and-features/README.md
Normal file
2
faqs/troubleshooting/ui-and-features/README.md
Normal file
@@ -0,0 +1,2 @@
|
||||
# UI and features
|
||||
|
||||
@@ -8,7 +8,7 @@ frame-ancestors 'none';
|
||||
|
||||
This blocks all iframing of Portainer.
|
||||
|
||||
If you need to allow iframing, you can disable the CSP header entirely by setting the [`--no-csp` flag](../../advanced/cli.md#configuration-flags-available-at-the-command-line) when running Portainer. 
|
||||
If you need to allow iframing, you can disable the CSP header entirely by setting the [`--no-csp` flag](../../../advanced/cli.md#configuration-flags-available-at-the-command-line) when running Portainer. 
|
||||
|
||||
{% hint style="danger" %}
|
||||
This removes **all** of the Content-Security-Policy header, so please use it with caution and at your own risk, and only if you **need** the iframing to work for you.
|
||||
@@ -8,7 +8,7 @@ When the [new image indicator](../host/setup.md#other) feature is enabled, the *
|
||||
|
||||
You can click the reload button next to the search box to recheck the images for all your containers for updates, or to recheck a single container's image you can click the image indicator icon for that container.
|
||||
|
||||
For more on how this works, have a look at [this knowledge base article](../../../faqs/troubleshooting/how-does-the-image-update-notification-icon-work.md).
|
||||
For more on how this works, have a look at [this knowledge base article](../../../faqs/troubleshooting/stacks-deployments-and-updates/how-does-the-image-update-notification-icon-work.md).
|
||||
|
||||
To add a new container, click **Add container**.
|
||||
|
||||
|
||||
@@ -12,7 +12,7 @@ When the [new image indicator](../swarm/setup.md#other) feature is enabled, the
|
||||
|
||||
You can click the **Reload image indicators** button to recheck the images for all your services for updates, or to recheck a single service's images you can click the image indicator icon for that service.
|
||||
|
||||
For more on how this works, have a look at [this article](../../../faqs/troubleshooting/how-does-the-image-update-notification-icon-work.md).
|
||||
For more on how this works, have a look at [this article](../../../faqs/troubleshooting/stacks-deployments-and-updates/how-does-the-image-update-notification-icon-work.md).
|
||||
|
||||
{% content-ref url="add.md" %}
|
||||
[add.md](add.md)
|
||||
|
||||
@@ -8,7 +8,7 @@ When the [new image indicator](../host/setup.md#other) feature is enabled, the *
|
||||
|
||||
You can click the **Reload image indicators** button to recheck the images for your stacks for updates, or to recheck a single stack's images you can click the image indicator icon for that stack.
|
||||
|
||||
For more on how this works, have a look at [this article](../../../faqs/troubleshooting/how-does-the-image-update-notification-icon-work.md).
|
||||
For more on how this works, have a look at [this article](../../../faqs/troubleshooting/stacks-deployments-and-updates/how-does-the-image-update-notification-icon-work.md).
|
||||
|
||||
{% content-ref url="add.md" %}
|
||||
[add.md](add.md)
|
||||
|
||||
@@ -144,7 +144,7 @@ If you have 2FA configured in GitHub, your passcode is your password.
|
||||
Portainer supports automatically updating your stacks deployed from Git repositories. To enable this, toggle on **GitOps updates** and configure your settings.
|
||||
|
||||
{% hint style="info" %}
|
||||
For more detail on how GitOps updates function under the hood, have a look at [this article](../../../faqs/troubleshooting/how-do-automatic-updates-for-stacks-applications-work.md).
|
||||
For more detail on how GitOps updates function under the hood, have a look at [this article](../../../faqs/troubleshooting/stacks-deployments-and-updates/how-do-automatic-updates-for-stacks-applications-work.md).
|
||||
{% endhint %}
|
||||
|
||||
| Field/Option | Overview |
|
||||
|
||||
Reference in New Issue
Block a user