Skip to content

Docker Compose Headless guide

Drew Thomasson edited this page Oct 11, 2025 · 10 revisions

The directory containing docker-compose.yml or podman-compose.yml becomes the base for file paths because the volumes: - ./:/app directive maps the host's project directory (.) to the container's /app working directory.

This means any file in the project root on your local machine is accessible inside the container.

To illustrate, here's how the paths for the same file look:

  • Path on Host: ~/ebook2audiobook/test.epub
  • Path in Container: /app/test.epub

So, to process a local file like test.epub, you just place it in the project root and reference it in the command as ./test.epub.

Example command:

Make this modification to the docker-compose.yml orpodman-compose.yml

From this

command: []

To this

command: ["--headless", "--ebook", "./tools/workflow-testing/test1.txt", "--tts_engine", "yourtts"]

./tools/workflow-testing/test1.txt is pointing to then test1.txt file located within the ebook2audiobook repo

Clone this wiki locally