r/portainer • • 2d ago

Deploying a Minecraft server panel as a Portainer stack: the one env var that matters (DATA_DIR_HOST)

0 Upvotes

I make a free, MIT Minecraft server panel (https://github.com/anefzaoui/minecraft-server-manager) and it runs fine as a Portainer stack, so here's the short version of how, plus the one thing that trips people up. Disclosure: I built it with Claude Code. I designed it, decided every feature, review the changes and test every release on our own servers, and Claude wrote most of the code.

What it does: the panel container gets the Docker socket and creates each Minecraft server as a sibling container on the itzg image, each with its own RAM/CPU cap. Modpacks from Modrinth/CurseForge/FTB are pinned, with a backup before every update and one-click rollback.

As a stack: Stacks → Add stack → paste the repo's docker-compose.yml (image ghcr.io/anefzaoui/minecraft-server-manager:latest, amd64 and arm64), then set one environment variable:

DATA_DIR_HOST=/opt/msm/data

Why that variable: the panel sees its data at /data inside its container, but when it asks Docker to bind-mount a server's folder into a new container, the daemon resolves the path on the host. DATA_DIR_HOST is the absolute host path behind the /data mount, and the panel re-roots every mount onto it. Without it, Docker would mount host folders that don't exist.

Then open port 25564, and the first run walks you through creating the admin.

Two cautions: anything with the Docker socket is root on the host, so keep it on your LAN/VPN or behind a TLS reverse proxy (publish 127.0.0.1:25564:25564 in that case). And you'll see the server containers show up in Portainer next to the panel, that's expected.

Java edition only, English UI.


r/portainer • • 8d ago

Delete Orphaned Stack With API

2 Upvotes

I had a one stack in a test environment that no longer exists. I delete the environment within Portainer, but the API reports the stack still exists.

If I do GET on /api/stacks/337?endpointId=1050 is returns the correct details, but a DELETE returns:

"message": "Unable to find the endpoint associated to the stack inside the database",
"details": "Object not found inside the database (bucket=endpoints, key=1050)"

Is there anyway of cleaning up this stack, and maybe any other left over stuff?


r/portainer • • 12d ago

Portainer 3 is Kubernetes-first, not Kubernetes-only

Thumbnail
portainer.io
7 Upvotes

r/portainer • • 14d ago

I’m building bananana.dev: a machine control room you can deploy as a Portainer stack

0 Upvotes

Hi everyone, I’m Roman, the developer of bananana.dev.

I’m working on Portainer template submissions, but those haven’t been merged yet. For now, the Brain runs as a regular Docker Compose stack in a Docker Standalone environment.

bananana.dev brings live readings, alerts, automations, files, terminals and history for servers, Macs and Windows PCs into one dashboard on your own hardware. It complements Portainer’s container management with a view of your other machines too.

For the current setup, use Portainer’s Stacks → Add stack → Web editor flow with the Compose from the Docker setup guide, and supply the setup token from bananana.dev/start.

You can use the web interface or iPhone/Android apps. Remote access uses an encrypted relay without router port-forwarding.

It’s closed source. The free plan covers one Brain, up to 10 devices and 10 GB of relay traffic a month.

Overview screenshot

If you run a mix of NAS boxes, servers and desktops, what would you want to see next to your existing Portainer setup?


r/portainer • • Oct 22 '26

The-Container-Platform-Threat-Model

Thumbnail hubs.li
6 Upvotes

This week has been an absolute disaster for IT security, with dozens of applications getting critical CVEs... and I foresee this is just the start...

Honestly, if your platform cannot protect you against these types of vulnerabilities, and if you cannot update your application estate on an almost as-needed basis, you are in BIG trouble.

Its exactly these types of issues that drove my (very hard) decision to focus Portainer.io version 3.x towards Kubernetes, as its realistically the only container platform secure enough to deal with the new AI threat landscape.

We also created D2K, a synthetic Docker environment, that looks and feels like Docker, but is actually Kubernetes.. and is immune from the weaknesses that Docker includes.

Have a read of the Container Platform Threat model (linked), and you can see the risks, and the mitigations available.

Realistically, if you run Docker, you need to plan to move to Kubernetes, especially if your apps are internet facing.


r/portainer • • Oct 16 '26

Portainer-AiGrid - Distributed AI RAG across your fleet

Thumbnail
youtu.be
3 Upvotes

Coming soon...

Put your Windows 11 and/or Kubernetes hosts to work after hours when they would otherwise sit idle...


r/portainer • • Oct 16 '26

Portainer-IDP, a developer self-service Portal for Kubernetes

Thumbnail
youtu.be
2 Upvotes

Now available in Portainer 2.45.2 LTS


r/portainer • • Oct 16 '26

Portainer-Command... safely use AI to manage your Kubernetes environment

Thumbnail
youtu.be
0 Upvotes

Now available in Portainer 2.45.2 LTS.


r/portainer • • Oct 16 '26

Portainer-Run, allow you business folk to safely and securely deploy their vibe-coded apps

Thumbnail
youtu.be
0 Upvotes

Now available in Portainer 2.45.2 LTS.


r/portainer • • Oct 10 '26

Edge Agent update schedule stuck “In progress” for over a month

1 Upvotes

About a month ago I set up an update schedule, and it’s been stuck ever since. I’ve had to manually SSH into each server and update the containers by hand. The problem has survived two Portainer updates.

Has anyone run into this, or know how to clear a stuck update schedule? I can’t find any documentation on what to do when it gets stuck like this.

I’m running Portainer Business Edition 2.45.2 LTS.


r/portainer • • Oct 05 '26

An unrequited love letter to Portainer

10 Upvotes

[LLM usage alert: used for anonymization]

Dear Portainer,

I chose you carefully.

I already had Docker. I already had Git. `master` for production, `develop` for staging. All I needed was a good Docker + Git CD platform, so I did my homework and chose you.

Meanwhile, my coworkers were deploying `.rar` files. If they were feeling fancy, `.zip`. Not even `.tgz`.

Then Jesus personally invented **a heap of linear algebra that spits out autocomplete**, and suddenly everybody was a developer.

So I got them on Git. They made Dockerfiles. They made stacks. They got staging and production. They got continuous deployment.

And now here we are:

**5 nodes. 50 applications. 100 developers.**

Everything happily chugging along.

Then you looked me in the eyes and said:

> **Friendship ended with Docker. Kubernetes is my best friend now.**

Portainer.

My love.

Now I have two choices:

**Kubernetes:** rework the entire codebase *and* infrastructure.

**Alternatively:** “only” rework the entire infrastructure.

After all the work I put into making this beautiful little Docker ecosystem work, this is how you repay me?

**We've been tricked. We've been backstabbed, and we've been, quite possibly, bamboozled.**


r/portainer • • Oct 03 '26

portainer no longer uses template name for stack

1 Upvotes

It used to be that the name for the stack would be filled in from the template name when selecting custom template to deploy. but it nolong does that, it just has the field empty. This iss annoying when having to troubleshoot a template and you have to detroy/deploy a bunch of times, and you have to retype the name every time. is there a variable that can be set in the compose file that will set it automatically so I don't have to remember what I was calling it?


r/portainer • • Sep 26 '26

403 error code during new portainer installation

4 Upvotes

I'm trying to set up portainer and create the initial admin user, but I keep getting this message: Failure — Request failed with status code 403

I followed this portainer doc to no avail. I cleared my cache/browser history, that didn't work. I tried an incognito browser/different browser and that didn't work either. Any ideas on how to resolve this issue? Thanks

edit: it was an issue with retrieving the setup token. figured it out with this guide https://docs.portainer.io/faqs/installing/setup-token


r/portainer • • Sep 20 '26

Portainer and Immich with a NAS Volume

2 Upvotes

Ok so what I'm trying to do is run Immich with Portainer using the stack feature. I'm basically trying to make it store the photos on a nas instead of the machine running my docker and its been one problem after another. I was hoping someone could give me some direction on this.

I followed the directions here: https://docs.immich.app/install/portainer

Under Volumes I added this:

immich_upload:

# Use the local storage driver.

driver: local

driver_opts:

type: "cifs"

o: "addr=172.16.x.x,username=Photo,password=VerySecurePAssword,vers=3.0"

# Points directly to the subfolder on the share

device: "//172.16.x.x/Photo"

The stack successfully creates but when I go to the site, I get "This site can’t be reached

172.16.8.31 refused to connect."

Any help would be appreciated.


r/portainer • • Sep 20 '26

Portainer Update Service (P.U.S.)

0 Upvotes

Hey r/portainer 👋

So I love Portainer for managing my homelab — but after ~14 stacks, the update routine got old: click into every stack, check the image, hit "redeploy", pray it comes back up, repeat 13 more times. And if something breaks mid-update? No backup was taken, no history of what happened.

So I built Portainer Update Service (PUS) — a companion app that speaks exclusively to the Portainer API and adds the whole update lifecycle around it:

The fail-safe update run:

  1. 🗄️ Portainer datastore backup (via the API, restorable)

  2. 🧹 Prune unused images + build cache

  3. 🚀 Redeploy ALL stacks (parallel, configurable)

  4. ⏳ Wait for every stack's containers to actually become healthy (not just "HTTP 200")

  5. 🔍 Reconciliation sweep — re-verifies everything after the run

  6. 🔧 Network integrity repairs (stale host-gateway mappings after network prunes)

  7. 🔄 Optionally updates Portainer itself last

Also included:

  • 📊 Dashboard: update badges per service (checked against docker.io/ghcr.io), last/next run, reclaimable space

  • ⏰ Scheduling: interval / daily / weekly (server-timezone aware)

  • 📌 Per-service version pinning with a registry tag browser — pick a known-good tag, apply, done

  • 📜 Run history with live logs — see exactly what happened in every run

  • 🧹 Cleanup stats: what did your prunes actually reclaim over the last 30 days

Why API-only: no docker socket scraping for the base setup, no host-side tooling. It's deployed as a Portainer stack itself — literally part of the stack list it manages. (It also refuses to redeploy its own stack during a run — there's a dedicated button for that, with a neutral "restarted" history entry so it doesn't show up as failed.)

Getting started: deploy as a Portainer stack from the repo (build method: Dockerfile), enter your Portainer URL + API key in the web UI, hit Test connection — done. Everything else is configurable in the UI.

MIT, self-hosted, no cloud, no telemetry.

Repo: https://github.com/joshmadison/Portainer-Update-Service

One honest note — contributors welcome: like many of you, my homelab time is limited, so I can't push features as fast as I'd like. The codebase is deliberately small and readable (single-file UI, Flask backend, no build step, no framework magic) — easy to jump into. Issues, feature requests, or contribution is welcome.


r/portainer • • Sep 18 '26

Kiwix (kiwix-tools) multiple data directories

1 Upvotes

Kiwix https://github.com/kiwix/kiwix-tools can be ran on a command line with multiple folders for the locations of the zims that are being served.

kiwix-serve /folder/subfolder/*.zim /folder2/someotherfolder/*.zim

and then you can access the zim files on the host via a web browser. Kiwix will conglomerate all the zims in both files and serve them all.

I can't figure out how to replicate this in the docker version of of kiwix-serve that's being managed by Portainer.


r/portainer • • Sep 16 '26

Enable polling feature - dont understand it

3 Upvotes

This seems to be a terrible description of the feature.

Not only does it "detect changes" on a remote source - it also appears to:

* Grab the new compose

* Redeploy the container with the new compose

* Check for newer images also and download? --> Which appears to be a behavior I can't change? What if I just want to grab the new compose and the compose doesn't change the image. Why is it grabbing a new image?

And it appears to be asynchronous so one failing pull blocks others.


r/portainer • • Sep 12 '26

Code 403

1 Upvotes

Hello, I’m having a problem logging in via the web; I keep getting error code 403 when entering the token. What can I do?


r/portainer • • Sep 11 '26

Portainer 3.0 is coming, and here's what it means for you

Thumbnail
portainer.io
79 Upvotes

We just published a post on Portainer 3.0 - our move to a Kubernetes-first codebase and a new family of single-purpose consoles, including one for deploying AI-built apps and one for agentic operations via MCP. If you're running Docker today, don't panic - nothing changes on 2.x, and we lay out exactly what your options are going forward.

Full details here: https://portainer.io/blog/portainer-3-0-is-coming


r/portainer • • Sep 03 '26

Teaser - Portainer-Command

Thumbnail
youtu.be
6 Upvotes

Here is a teaser of Portainer-Command, a new product from Portainer. Coming soon :-)

Portainer-Command is an enterprise MCP server for governing Al access to Kubernetes clusters. It comes with a tiny, carefully designed set of extremely token efficient tools:
- It grants an Al agent namespace jailed, read only K&s service accounts that auto expire.
- It gives Al a synthetic git endpoint that Al can use to read the desired GitOps state for a K&s cluster and open PR's to propose changes
- After a human approves an Al proposed change, Portainer reconciles generated manifests and helm chart state with your K8s cluster to apply the changes
- If something goes wrong you can easily rollback to past known good states from Git history
For CISO's and AppSec teams, Portainer-Command will be a dream come true:
- Full auditable tracking of every Al access to your fleet, its justification, and confidence that access automatically expires
- "Emergency Halt" button to instantly eject
Al agents from your fleet, or cut off a misbehaving agent
- Built-in, local Al capable workspace (OpenCode based) that helps ensure your data and secrets stay on your own infrastructure.
- Token and cost tracking for when you choose to use a remote Al provider


r/portainer • • Sep 02 '26

Auto pull containers with portainer?

Thumbnail reddit.com
0 Upvotes

Hey friends!

I'm running a modest home lab and I've been using portainer to manage containers. I know they offer the business edition free for 3 nodes but now I'm at 5 (Synology, pi, and some mini pcs).

With AI being what it is, I'm enjoying building small apps that solve specific problems for me. I'm deploying them as docker apps. My issue is that my AI agent is pushing commits to forgejo, which then builds a new container for my app, but portainer doesn't allow for pulling an updated container, so I need to manually login and do that. It seems silly and solveable. Has anyone run into this and found a good solution?

My containers are not hosted publicly anywhere. They are built on the VM where they run.

I think the answers here will be one of:

A) There is a way to have portainer-ce pull images automatically.

B) Downsize and switch to business edition with 3 free nodes.

C) switch to something else?

D) you tell me?

I don't really want to lose portainer because it's convenient, but I'm also not a business, just a hobbyist. Prefer to keep portainer, open to alternatives though.


r/portainer • • Aug 30 '26

What's wrong with sorting by name?

8 Upvotes

I would think this would be the default in the new release...what am I missing?


r/portainer • • Aug 28 '26

Learn.Portainer.io

16 Upvotes

As a replacement for the Portainer Academy, we have started creating this learning site.. it goes very deep into every feature/function of Portainer (Business)…

Its still needing a full week of additional QA before offical release, and we are adding in screenshots to help break up the text, but a question for you..

Are you ok with links to docs for lab cli commands, or do you prefer them embedded in the training lessons? I was trying to reduce duplication, but im not sure if it works or not.


r/portainer • • Aug 27 '26

That part definitely turned out awful.

9 Upvotes

Honestly, why did they do that? They should reconsider... it's completely misaligned... it looks like something done by some AI without a proper prompt.