Improving Atheos container deployment (Podman, persistence, permissions)

[JayHsu397]

Hi,
I've been deploying Atheos on my homelab machine for a long time. I wanted to deploy it with Podman (a Docker alternative which can run rootless) recently, but I've encountered a few issues during deployment.

• Permission Problem: Even if you chown your local dir to 33(www-data), it still doesn't work since the uid doesn't present the same number after uid remapping between the container and the host machine. e.g. uid 33 in the container turns out to be uid 100032 on the host in my case.

• Data Persistence: If you don't do data persistence, you will have to initialize your userName, password, and project dir every time you recreate the container.

Since Atheos has been an important element of my homelab, I decided to figure out a solution, which is atheos-container.

It contains:

• data persistence guide
• documented bind-mount & named-mount behavior
• optional permission fixup for host-mounted paths
• Quadlet/systemd deployment examples
• CI workflow (Github Action) to build the image every five days

My goal here is not to criticize the current Docker setup, but to contribute something practical back to the project.

If you think this approach is useful, I'd be happy to help in a more ongoing way on the container/deployment side of Atheos, for example:

• improving container packaging
• maintaining deployment documentation
• helping with persistence / permission related issues
• testing updates for Docker / Podman compatibility

I'm also happy to start by opening PRs first if that's the preferred workflow.

Would you be open to collaboration on the Atheos container side?