>
Linux

Portainer froze the free build, and the panic is louder than the news

If you run Portainer (a graphical front-end for managing Docker and Kubernetes containers) on a home server, you have probably seen the panic online this month. The Community Edition is parked on 2.45 LTS, the new 3.0 release is closed source, and the comment sections are full of people who feel betrayed. I want to talk about why the announcement is a smaller deal in practice than the comments make it sound, and what the actual decision tree looks like for someone running a homelab stack.

A maintenance freeze on a piece of open source software is a specific event, not a general feeling. It means the team stops adding new features to that branch while continuing to ship security patches and bug fixes. The branch is not abandoned. The branch is on life support, and on life support the patient can live for years. That is the reality most people running Portainer CE will keep running into for the next several years, and it is a very different reality than “the software is dead, delete it from your server today.”

Why Portainer actually made the call

Neil Cresswell was blunt about the reason. The team was rebuilding the same feature three times, once for Kubernetes, then again for Swarm, then a third time for plain Docker or Podman (two popular container runtimes, with Podman being a daemonless alternative to Docker). Every time they added a new policy mode or a new operations API call, they had to write it three ways, test it three ways, and ship it three ways. For a small company, that is a slow bleed. The CEO’s framing was that releasing the rebuilt Kubernetes-first code as Community Edition would misrepresent what it is and who it is for. That is an honest read of the situation.

The practical implication for someone running a stack of containers on a single box is small. The 2.45 LTS branch keeps getting security patches and bug fixes on a real schedule. Backports of new features are happening where the underlying Docker API surface supports them. Anything that requires Kubernetes primitives (the building blocks a Kubernetes cluster exposes, such as pods, services, and custom resource definitions) is the part that does not land in CE. Most homelab setups do not need those primitives.

What you actually lose and what you keep

For a Docker or Podman setup, the day-to-day experience does not change this month. Your stacks keep deploying, your dashboards keep showing up, your agents keep connecting. The new features that did not make it into CE are aimed at Kubernetes users, and they include observability tooling, GitOps workflows (where configuration in a Git repository automatically drives the running system), and a policy engine that assumes a much bigger environment than a homelab. If none of those words match your workflow, the freeze is theoretical for you.

The only people who feel the freeze immediately are the ones who were waiting for a specific Portainer feature to land in their free build. The roadmap is now officially Kubernetes-first, which means anything in that bucket will appear in 3.x months before it appears anywhere the free build can use it. If you were planning to grow into Kubernetes through Portainer as a free user, that path just got longer.

For everyone else, the honest split is this:

  • Plain Docker or Podman stacks: stay on CE 2.45 LTS for the foreseeable future. Patches will keep coming and your daily workflow is unaffected.
  • Kubernetes clusters chasing the new observability, GitOps, and policy tooling: plan a migration to 3.x and accept the closed-source tradeoff.
  • Anyone who wanted a free path to the new features without Kubernetes: that door is closed today, and there is no timeline for it reopening.

That third bullet is the part the panic posts do not acknowledge. The people complaining the loudest are usually the ones who wanted the new features without paying, and that is a real loss, but it is also a different loss than “the software is dead.”

The 3-node free path is not what it sounds like

Portainer does offer a way to touch 3.x without paying. The 3 Nodes Free tier for the closed Business Edition lets you run the new platform on up to three machines (physical or virtual) at no cost. That is a real offer and it does what it says on the tin. It is also not Community Edition, and it is not open source, even though the code on the wire might feel similar to anyone who is not reading the source.

For a homelab tinkerer this is a fair deal. For someone who picked Portainer specifically because the binary they run on their home server was readable and modifiable, it stings in a specific way. You can still run the software. You can still connect it to your containers. You just cannot rebuild the platform if you want to. That is the difference between open source and source-available, and it is worth being precise about which one you are actually choosing.

What the alternatives actually look like

The honest answer is that the alternatives depend on what you actually use Portainer for. If the answer is “I want a web UI to deploy Docker Compose files (YAML-formatted recipes that describe a multi-container application) and look at logs,” you do not need Portainer at all. Plain docker compose plus a static web UI like Yacht or a YAML editor gets you most of the way. The pieces Portainer added on top are real, but they are not irreplaceable.

If the answer is “I run a small Kubernetes cluster and want a dashboard,” the alternative list is longer and more competitive. Open source dashboards like Kubernetes Dashboard or Headlamp do most of the same jobs Portainer 3.x is aiming at, with a much smaller feature gap to the rest of the Kubernetes tooling landscape. The cost is that you have to maintain them yourself. The benefit is that the code is yours.

There is also a third category, the small set of newer projects that aim at the homelab use case Portainer used to serve well. Komodo is one I have been watching. It is a young Rust application targeting small service stacks, designed for people who want a build-and-deploy UI without dragging Kubernetes into their weekend projects. It is being maintained by people who think the homelab is a real market, and that matters because most homelab tooling has been an afterthought at the bigger vendors. I have not put Komodo through the same kind of stress test I have put Portainer through over the years, so I would not tell you to migrate on a Tuesday afternoon. But it is worth keeping in the back of your mind.

Trade-offs

The honest cost of staying on Portainer CE 2.45 LTS is that you are accepting a maintenance branch. Patches will keep coming, features will not. The longer you stay, the more you will be running software that the upstream team is not actively developing, and the more your environment will drift from the rest of the container tooling community. For a homelab that is fine. For a production environment that needs to track upstream, it is a real cost.

Moving to the 3 Nodes Free license is not free in the same sense that CE was. You give up the right to read and modify the platform code, and you accept that the binary on your server is whatever the vendor ships. That is the same trade-off you make with any closed-source tool, and it is a reasonable one for many people. It is just not the same trade-off you were making when you picked CE.

Migrating to an alternative is its own project. Plain docker compose works without a dashboard if you are willing to learn the CLI. Kubernetes Dashboard or Headlamp work if you actually have a Kubernetes cluster. Komodo works if you have time to test it before you trust it. None of those moves is a weekend project for a stack with more than a handful of services.

Here is the trade-off summary by choice:

  • Stay on CE 2.45 LTS: zero migration cost, ongoing security patches, no new features, accepts upstream drift over years.
  • Move to 3 Nodes Free: zero licensing cost, can touch new features, gives up source-readable code, binary is vendor-controlled.
  • Switch to plain docker compose plus a static UI: maximum control, smallest migration step, loses Portainer’s value-add features (RBAC (role-based access control), agents, multi-host views).
  • Switch to a Kubernetes-native dashboard (Kubernetes Dashboard or Headlamp): keeps the dashboard model, but assumes you actually want Kubernetes, which most homelab setups do not.

What I would tell past me

If I could send a message back to the version of me who first installed Portainer, three things would be on the list.

  • A maintenance freeze is a specific event with a specific cost, and the cost is smaller than the panic posts make it sound.
  • The reason a vendor freezes a free build is usually that the rebuild no longer fits the free build, not that the vendor has stopped caring about users like you.
  • When you pick open source infrastructure, the question is not whether the software will outlive the current business model. The question is what your stack looks like when the answer turns out to be no.

For most homelab readers the answer today is “do nothing, stay on 2.45 LTS, and check back in six months.” That is the boring answer, and it is the right one.

Leave a comment