This directory contains OCI-compatible Containerfiles (Dockerfiles) for building the Android File Handler on different Linux distributions. These images match exactly the images used in the CI/CD pipeline.

The project uses Podman as the container runtime. All commands below use Podman; if you have Docker installed, the Dockerfiles are OCI-compatible and will work with Docker as well.

Quick Start

Using Podman Compose (Recommended)

Build for all distributions:

podman-compose up --build

Build for a specific distribution:

podman-compose up --build debian
podman-compose up --build arch
podman-compose up --build rhel

Using Prefect + Dagger (CI Pipeline Locally)

The CI/CD pipeline uses Prefect and Dagger to orchestrate builds. You can run it locally:

poetry install --with ci
poetry run python -m ci.prefect_flow build-linux

Manual Podman Build

Build the image:

# Debian
podman build -f scripts/docker/Dockerfile.debian -t android-file-handler-debian-builder .

# Arch
podman build -f scripts/docker/Dockerfile.arch -t android-file-handler-arch-builder .

# RHEL/Fedora
podman build -f scripts/docker/Dockerfile.rhel -t android-file-handler-rhel-builder .

Run the build:

# Debian
podman run --rm -v $(pwd):/workspace:Z -w /workspace android-file-handler-debian-builder

# Arch
podman run --rm -v $(pwd):/workspace:Z -w /workspace android-file-handler-arch-builder

# RHEL/Fedora
podman run --rm -v $(pwd):/workspace:Z -w /workspace android-file-handler-rhel-builder

Output

After building, you'll find:

dist/ - Final packaged files (.deb, .rpm, .pkg.tar.zst)
pkg_dist_{distro}/ - Staging directories for package contents
dist_{distro}/ - PyInstaller build outputs

Images

Debian Builder

Image: ghcr.io/jmr-dev/android-file-handler-debian-builder:debian13-trixie
Base: debian:13
Python: 3.13 (via pyenv)
Tools: Poetry, fpm, PyInstaller

Arch Builder

Image: ghcr.io/jmr-dev/android-file-handler-arch-builder:latest
Base: archlinux:latest
Python: 3.13 (via pyenv)
Tools: Poetry, fpm, PyInstaller

RHEL Builder

Image: ghcr.io/jmr-dev/android-file-handler-rhel-builder:fedora42
Base: fedora:42
Python: 3.13 (via pyenv)
Tools: Poetry, fpm, PyInstaller

Troubleshooting

Virtualenv Conflicts

The Podman Compose configuration automatically excludes the host's .venv directory to prevent conflicts between the host Python environment and the container Python environment. Each container creates its own virtualenv in /tmp/poetry-cache.

If you encounter virtualenv-related errors, ensure you're using the latest podman-compose.yml configuration.

SELinux (Fedora/RHEL hosts)

Volume mounts use the :Z suffix to apply the correct SELinux labels automatically. If you encounter permission errors, ensure the :Z suffix is present on volume mounts.

Cleaning Up

Remove build artifacts:

rm -rf dist pkg_dist_* dist_*

Remove Podman containers and volumes:

podman-compose down -v

Customization

Override FPM Version

Build with a specific fpm version:

docker-compose build --build-arg FPM_VERSION=1.15.0 debian

Environment Variables

All builds use these environment variables:

CI_CD=true - Runs in CI/CD mode
DISTRO_TYPE - Set to debian, arch, or rhel
FPM_VERSION - Version of fpm to use (default: 1.16.0)

Notes

All images use Python 3.13 built from source with tkinter support
The builds are identical to what runs in GitHub Actions
Poetry and fpm are pre-installed in all images
The Python build script handles both PyInstaller and fpm packaging