Add Dockerfile and entrypoint for container deployment

[rh-john]

Summary

• Add a minimal Dockerfile (python:3.12-slim, non-root, multi-arch) and entrypoint.sh with env-var-driven configuration, persistent pairing DB via /data volume, and forward-compatible accessory support for PR Add standalone HomeKit accessory support (e.g. Smart AC Control V3+) #40
• Add .dockerignore to keep images lean
• Update INSTALLATION.md with "Method 4: Container (Docker/Podman)" section covering build, first-time pairing, subsequent runs, and environment variables; remove "Add Docker support" from Future Work

Details

The entrypoint handles three scenarios:

1. No bridge IP and no pairing DB — sleeps with a helpful message
2. First-time pairing — requires TADO_BRIDGE_IP and TADO_BRIDGE_PIN
3. Subsequent runs — only TADO_BRIDGE_IP needed (pairing DB persisted in volume)

Uses exec to replace the shell so signals propagate correctly to the tado-local process.

Relates to #6
Relates to #12

Test plan

• docker build -t tado-local . succeeds on AMD64
• podman build -t tado-local . succeeds on ARM64
• Container starts and sleeps when no TADO_BRIDGE_IP is set
• Container starts and pairs when bridge IP and PIN are provided
• Pairing DB persists across container restarts via /data volume
• Container runs as non-root (UID 1000)

[Bekkie]

Looks good to me, after merging #40 will merge this one.

[rhuijben]

Thanks!

[SanderNijdam]

Will this become available on Docker Hub? That would make installing it on a NAS a lot simpler.

[Bekkie]

Will this become available on Docker Hub? That would make installing it on a NAS a lot simpler.

I do not have experience in pushing an image to Docker Hub @rhuijben or @rh-john do you?

[SanderNijdam]

There already seems to be a version of tadolocal on Docker Hub:
https://hub.docker.com/r/maartenmol/tadolocal
However, I cannot get this to work as there is no documentation on the variable names and therefore it cannot find the PIN.

[john-johansson]

I added build and push CI to my fork. So whenever I update it, you'll find hosted images at quay.io/john_johansson/tadlocal - I will keep this public until this project implement its own official registry.

You can pull either latest, a specific version or a branch:

docker pull quay.io/john_johansson/tadlocal:latest
docker pull quay.io/john_johansson/tadlocal:1.1.1
docker pull quay.io/john_johansson/tadlocal:main

[SanderNijdam]

Thanks!
I managed to install it on my Synology NAS. However, when running it I get these errors and then it shuts down immediately:
ERROR Database migration check failed: unable to open database file
ERROR ERROR: Failed to start Tado Local: unable to open database file

[john-johansson]

Most likely due to the fact that the container is running with a unprivliged UID and not as root. To accomdate for this, you'd have to modify the Dockerfile and build your own container image.

FROM python:3.12-slim

RUN apt-get update \
    && apt-get install -y --no-install-recommends libdbus-1-3 \
    && rm -rf /var/lib/apt/lists/*

COPY . /app
RUN pip install --no-cache-dir /app \
    && chmod +x /app/entrypoint.sh

VOLUME /data
EXPOSE 4407

ENTRYPOINT ["/app/entrypoint.sh"]

[SanderNijdam]

Sorry for the very late reply. But no, running it with "Execute container with high privilige" does not change anything. Modifying the Dockerfile and building my own image is difficult on a Synology NAS. Any other suggestions?