From a11588ceb862b2c1620035e64a80092de32bf56f Mon Sep 17 00:00:00 2001 From: Hannah Cooper Date: Fri, 6 Mar 2026 02:20:00 +0000 Subject: [PATCH] GITBOOK-3: Changes to FAQ landing pages + known issues --- SUMMARY.md | 1 - faqs/contributing/README.md | 4 ---- faqs/getting-started/README.md | 12 ----------- faqs/getting-support/README.md | 3 --- faqs/installing/README.md | 18 ----------------- faqs/known-issues/README.md | 14 ------------- ...ware-acceleration-gpu-button-is-missing.md | 4 ++-- .../nomad-jobs-only-displays-service-jobs.md | 20 ------------------- ...s-to-acr-with-service-principal-account.md | 4 ++-- faqs/licensing/README.md | 19 ------------------ faqs/upgrading/README.md | 9 --------- 11 files changed, 4 insertions(+), 104 deletions(-) delete mode 100644 faqs/known-issues/nomad-jobs-only-displays-service-jobs.md diff --git a/SUMMARY.md b/SUMMARY.md index c42631fa..b43ec835 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -423,7 +423,6 @@ * [Hardware Acceleration GPU button is missing](faqs/known-issues/hardware-acceleration-gpu-button-is-missing.md) * [Unable to update environment variables when running on Synology NAS](faqs/known-issues/unable-to-update-environment-variables-when-running-on-synology-nas.md) * [Unable to remove the Group Configuration from Active Directory authentication configuration](faqs/known-issues/unable-to-remove-the-group-configuration-from-active-directory-authentication-configuration.md) - * [Nomad Jobs only displays Service Jobs](faqs/known-issues/nomad-jobs-only-displays-service-jobs.md) * ["Image not found on registry" error when upgrading from CE to BE or self-updating on Synology NAS](faqs/known-issues/image-not-found-on-registry-error-when-upgrading-from-ce-to-be-or-self-updating-on-synology-nas.md) * [MicroK8s Known Issues](faqs/known-issues/microk8s-known-issues.md) * ["Unauthorized" error when pushing images to ACR with Service Principal account](faqs/known-issues/unauthorized-error-when-pushing-images-to-acr-with-service-principal-account.md) diff --git a/faqs/contributing/README.md b/faqs/contributing/README.md index 908fb32c..c9ab8196 100644 --- a/faqs/contributing/README.md +++ b/faqs/contributing/README.md @@ -9,7 +9,3 @@ metaLinks: # Contributing -* [How do I report a bug?](how-do-i-report-a-bug.md) -* [How do I raise a feature request?](how-do-i-raise-a-feature-request.md) -* [How do you decide which bugs and features to work on first?](how-do-you-decide-which-bugs-and-features-to-work-on-first.md) -* [How do I log a Support Request?](how-do-i-log-a-support-request.md) diff --git a/faqs/getting-started/README.md b/faqs/getting-started/README.md index 1ccd32ba..22b97ae7 100644 --- a/faqs/getting-started/README.md +++ b/faqs/getting-started/README.md @@ -9,15 +9,3 @@ metaLinks: # Getting started -* [How do I get started with Portainer?](how-do-i-get-started-with-portainer.md) -* [What is Portainer's architecture?](what-is-portainers-architecture.md) -* [What information does Portainer collect?](what-information-does-portainer-collect.md) -* [Can I use Portainer CE in a production environment?](can-i-use-portainer-ce-in-a-production-environment.md) -* [How does Portainer secure connectivity to and from Agents and Edge Agents?](how-does-portainer-secure-connectivity-to-and-from-agents-and-edge-agents.md) -* [Which is more secure, the Agent or the Edge Agent?](which-is-more-secure-the-agent-or-the-edge-agent.md) -* [What does Portainer's backup include?](what-does-portainers-backup-include.md) -* [How does Portainer respond to CVEs?](how-does-portainer-respond-to-cves.md) -* [Can Portainer's interface language be changed?](can-portainers-interface-language-be-changed.md) -* [Why shouldn't I give all Portainer users admin access?](why-shouldnt-i-give-all-portainer-users-admin-access.md) -* [Why do we recommend using the Edge Agent instead of the traditional Agent?](why-do-we-recommend-using-the-edge-agent-instead-of-the-traditional-agent.md) - diff --git a/faqs/getting-support/README.md b/faqs/getting-support/README.md index 65c5f14a..cfc0c94c 100644 --- a/faqs/getting-support/README.md +++ b/faqs/getting-support/README.md @@ -9,6 +9,3 @@ metaLinks: # Getting support -* [How to get support for Community Edition and 5 Nodes Free Users](how-to-get-support-for-community-edition-and-5-nodes-free-users.md) -* [How to get support for Business Edition Customers with a subscription](how-to-get-support-for-business-edition-customers-with-a-subscription.md) -* [Which versions of Portainer do you provide support for?](which-versions-of-portainer-do-you-provide-support-for.md) diff --git a/faqs/installing/README.md b/faqs/installing/README.md index 93ee3bbb..768672a1 100644 --- a/faqs/installing/README.md +++ b/faqs/installing/README.md @@ -9,21 +9,3 @@ metaLinks: # Installing -* [How do I install Portainer?](how-do-i-install-portainer.md) -* [Can I run Portainer on my configuration?](can-i-run-portainer-on-my-configuration.md) -* [How do I change the port that Portainer runs on?](how-do-i-change-the-port-that-portainer-runs-on.md) -* [My host is using SELinux. Can I use Portainer?](my-host-is-using-selinux.-can-i-use-portainer.md) -* [Does Portainer support WSL1?](does-portainer-support-wsl1.md) -* [Which ARM architectures does Portainer support?](which-arm-architectures-does-portainer-support.md) -* [Portainer isn't starting on my Windows server -help!](portainer-isnt-starting-on-my-windows-server-help.md) -* [How can I ensure Portainer's configuration is retained?](how-can-i-ensure-portainers-configuration-is-retained.md) -* [Does Portainer support TLS for socket connections?](does-portainer-support-tls-for-socket-connections.md) -* [How do I remove Portainer?](how-do-i-remove-portainer.md) -* [Does Portainer support Podman?](does-portainer-support-podman.md) -* [How can I deploy the Portainer Agent on a Swarm cluster with Linux and Windows nodes?](how-can-i-deploy-the-portainer-agent-on-a-swarm-cluster-with-linux-and-windows-nodes.md) -* [Portainer fails to deploy on Vultr's VKE platform](portainer-fails-to-deploy-on-vultrs-vke-platform.md) -* [I just installed Portainer but I can't access the UI, how do I fix this?](i-just-installed-portainer-but-i-cant-access-the-ui-how-do-i-fix-this.md) -* [Does Portainer support containerd?](does-portainer-support-containerd.md) -* [I get the message "Your Portainer instance has timed out for security purposes" after installing Portainer, how do I fix this?](your-portainer-instance-has-timed-out-for-security-purposes-error-fix.md) -* [Can I use internal authentication and external authentication at the same time?](can-i-use-internal-authentication-and-external-authentication-at-the-same-time.md) - diff --git a/faqs/known-issues/README.md b/faqs/known-issues/README.md index cdc2b37e..1d34eb1f 100644 --- a/faqs/known-issues/README.md +++ b/faqs/known-issues/README.md @@ -9,17 +9,3 @@ metaLinks: # Known issues -* [Edge stacks do not support authenticating against a private registry to deploy applications stored on private registries](edge-stacks-do-not-support-authenticating-to-deploy-applications-from-private-registries.md) -* [Known issues with VMware](known-issues-with-vmware.md) -* [Groups info issue with OAuth using Microsoft AD](groups-info-issue-with-oauth-using-microsoft-ad.md) -* [Resource limits in a compose file are not applying](resource-limits-in-a-compose-file-are-not-applying.md) -* [Hardware Acceleration GPU button is missing](hardware-acceleration-gpu-button-is-missing.md) -* [Unable to update environment variables when running on Synology NAS](unable-to-update-environment-variables-when-running-on-synology-nas.md) -* [Unable to remove the Group Configuration from Active Directory authentication configuration](unable-to-remove-the-group-configuration-from-active-directory-authentication-configuration.md) -* [Nomad Jobs only displays Service Jobs](nomad-jobs-only-displays-service-jobs.md) -* ["Image not found on registry" error when upgrading from CE to BE, or using the self-update feature running on a Synology NAS](image-not-found-on-registry-error-when-upgrading-from-ce-to-be-or-self-updating-on-synology-nas.md) -* [MicroK8s Known Issues](microk8s-known-issues.md) -* ["Unauthorized" error when pushing images to ACR with Service Principal account](unauthorized-error-when-pushing-images-to-acr-with-service-principal-account.md) -* ["Invalid certificate file" error when browsing empty Azure Container Registry](invalid-certificate-file-error-when-browsing-empty-azure-container-registry.md) -* [Environments not loading with Docker Engine 29.0.0](environments-not-loading-with-docker-engine-29.0.0.md) -* [Docker Compose files including build steps fail](docker-compose-files-including-build-steps-fail.md) diff --git a/faqs/known-issues/hardware-acceleration-gpu-button-is-missing.md b/faqs/known-issues/hardware-acceleration-gpu-button-is-missing.md index 60fd7748..dd47b5ce 100644 --- a/faqs/known-issues/hardware-acceleration-gpu-button-is-missing.md +++ b/faqs/known-issues/hardware-acceleration-gpu-button-is-missing.md @@ -8,9 +8,9 @@ metaLinks: # Hardware Acceleration GPU button is missing {% hint style="info" %} -**Affected versions:** 2.15.0 and above +**Affected versions:** 2.15.0, 2.16.0, 2.17.0 -**Fixed in:** Upcoming release +**Fixed in:** 2.18.0 and above {% endhint %} #### Issue Description diff --git a/faqs/known-issues/nomad-jobs-only-displays-service-jobs.md b/faqs/known-issues/nomad-jobs-only-displays-service-jobs.md deleted file mode 100644 index 07ff2b78..00000000 --- a/faqs/known-issues/nomad-jobs-only-displays-service-jobs.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -metaLinks: - alternates: - - >- - https://app.gitbook.com/s/xdTQRpMuktD2l0URtOJO/faqs/known-issues/nomad-jobs-only-displays-service-jobs ---- - -# Nomad Jobs only displays Service Jobs - -{% hint style="info" %} -**Affected Versions:** 2.14.0 to 2.19.4 (Nomad support was removed in 2.20.0) -{% endhint %} - -#### Issue Description - -Nomad Jobs are only displaying Service Jobs. - -#### Cause - -This issue is the result of a bug where System, Batch and Sysbatch Jobs are causing the Portainer UI to break. To avoid this bug we currently only display Service Jobs in the Portainer UI. diff --git a/faqs/known-issues/unauthorized-error-when-pushing-images-to-acr-with-service-principal-account.md b/faqs/known-issues/unauthorized-error-when-pushing-images-to-acr-with-service-principal-account.md index 11e7f2d6..1de1cd70 100644 --- a/faqs/known-issues/unauthorized-error-when-pushing-images-to-acr-with-service-principal-account.md +++ b/faqs/known-issues/unauthorized-error-when-pushing-images-to-acr-with-service-principal-account.md @@ -8,9 +8,9 @@ metaLinks: # "Unauthorized" error when pushing images to ACR with Service Principal account {% hint style="info" %} -**Affected versions:** 2.13.0 and above +**Affected versions:** 2.13.0 to 2.16.0 -**Fixed in:** Upcoming release +**Fixed in:** 2.17.0 {% endhint %} #### Issue Description diff --git a/faqs/licensing/README.md b/faqs/licensing/README.md index 3e8f950b..b36ea24e 100644 --- a/faqs/licensing/README.md +++ b/faqs/licensing/README.md @@ -9,22 +9,3 @@ metaLinks: # Licensing -* [What is a node for licensing purposes?](what-is-a-node-for-licensing-purposes.md) -* [How do I add more nodes to my license?](how-do-i-add-more-nodes-to-my-license.md) -* [How do I renew my subscription?](how-do-i-renew-my-subscription.md) -* [What is the pricing for Business Edition?](what-is-the-pricing-for-business-edition.md) -* [How do I enter my Portainer Business license into Portainer CE?](how-do-i-enter-my-portainer-business-license-into-portainer-ce.md) -* [How can I move my license from one instance to another?](how-can-i-move-my-license-from-one-instance-to-another.md) -* [Is there a way to specify the license at the command line?](is-there-a-way-to-specify-the-license-at-the-command-line.md) -* [Can I use the same license key across Dev, QA and Prod environments and use a single Portainer instance to manage all?](can-i-use-the-same-license-key-portainer-instance-across-dev-qa-and-prod-environments.md) -* [Can I use the same license key across my private network and my public network and use a single Portainer instance to manage both?](can-i-use-the-same-license-key-portainer-instance-across-my-private-network-and-my-public-network.md) -* [Error: License already applied](license-already-applied-error.md) -* [My Portainer Extensions license has expired. What can I do?](my-portainer-extensions-license-has-expired.-what-can-i-do.md) -* [Error: A valid authorisation token is missing](a-valid-authorisation-token-is-missing-error.md) -* [Can we add our Business Edition license to Portainer running in Docker Desktop Extension?](can-we-add-our-business-edition-license-to-portainer-running-in-docker-desktop-extension.md) -* [Switching from Trial License to 3 Free Nodes License](switching-from-trial-license-to-3-free-nodes-license.md) -* [I want to use my License in a different environment. How do I do this?](i-want-to-use-my-license-in-a-different-environment.-how-do-i-do-this.md) -* [Why isn’t my 3- license key working?](why-isnt-my-3-license-key-working.md) -* [How do I renew my 3 nodes free license?](how-do-i-renew-my-3-nodes-free-license.md) -* [How do I renew my 5 nodes free license?](how-do-i-renew-my-5-nodes-free-license.md) - diff --git a/faqs/upgrading/README.md b/faqs/upgrading/README.md index 861c966e..0cbaebaf 100644 --- a/faqs/upgrading/README.md +++ b/faqs/upgrading/README.md @@ -7,12 +7,3 @@ metaLinks: # Upgrading and downgrading -* [How do I upgrade Portainer to the latest version?](how-do-i-upgrade-portainer-to-the-latest-version.md) -* [Can I upgrade from Portainer Community Edition to Portainer Business Edition?](can-i-upgrade-from-portainer-community-edition-to-portainer-business-edition.md) -* [After upgrading, why doesn’t my version number match the latest version?](after-upgrading-why-doesnt-my-version-number-match-the-latest-version.md) -* [Why does Portainer keep prompting me to upgrade?](why-does-portainer-keep-prompting-me-to-upgrade.md) -* [Why have my agents stopped working after upgrading Portainer?](why-have-my-agents-stopped-working-after-upgrading-portainer.md) -* [Can I upgrade an environment from Docker Standalone to Docker Swarm?](can-i-upgrade-an-environment-from-docker-standalone-to-docker-swarm.md) -* [Can I downgrade from Portainer Business to Portainer CE?](can-i-downgrade-from-portainer-business-to-portainer-ce.md) -* [Why do my users no longer have access after upgrading to BE from CE?](why-do-my-users-no-longer-have-access-after-upgrading-to-be-from-ce.md) -