From 30d12dafed210316431a57349adfdb2128078feb Mon Sep 17 00:00:00 2001 From: Florian Preinstorfer Date: Fri, 12 Sep 2025 22:11:25 +0200 Subject: [PATCH] Add FAQ entry about the recommended upgrade path --- docs/about/faq.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/about/faq.md b/docs/about/faq.md index e4711a13..49127bf4 100644 --- a/docs/about/faq.md +++ b/docs/about/faq.md @@ -44,6 +44,15 @@ For convenience, we also [build container images with headscale](../setup/instal we don't officially support deploying headscale using Docker**. On our [Discord server](https://discord.gg/c84AZQhmpx) we have a "docker-issues" channel where you can ask for Docker-specific help to the community. +## What is the recommended update path? Can I skip multiple versions while updating? + +Please follow the steps outlined in the [upgrade guide](../setup/upgrade.md) to update your existing Headscale +installation. Its best to update from one stable version to the next (e.g. 0.24.0 → 0.25.1 → 0.26.1) in case +you are multiple releases behind. You should always pick the latest available patch release. + +Be sure to check the [changelog](https://github.com/juanfont/headscale/blob/main/CHANGELOG.md) for version specific +upgrade instructions and breaking changes. + ## Scaling / How many clients does Headscale support? It depends. As often stated, Headscale is not enterprise software and our focus