Podocracy self-hosted

Run voiceover translation on your own machine

The hosted app is being retired. Podocracy is now distributed as a local Docker Compose portal, so you can process projects with your own provider key and keep project files on your computer.

Why self-host?

You avoid paying for Podocracy-hosted compute that sits idle between projects.
Your OpenAI usage is billed directly to your own account, without an extra hosted-service markup.
Audio, logs, manifests, and generated artifacts stay in a local project folder by default.

Quick start with prebuilt images

Install Docker Desktop on macOS or Windows, or Docker Engine on Linux.
Create a folder for the portal and its projects.
Add an OPENAI_API_KEY value to a local .env file.
Download the prebuilt-image Compose file and start the portal.
Open http://localhost:8080.

mkdir -p "$HOME/podocracy-worker-portal/projects"
cd "$HOME/podocracy-worker-portal"
printf 'OPENAI_API_KEY=replace-with-your-openai-key\n' > .env
curl -fsSLO https://raw.githubusercontent.com/cloudsecmentor/podocracy-app/main/docker-compose.images.yml
docker compose --env-file .env -f docker-compose.images.yml up -d

Update later

docker compose --env-file .env -f docker-compose.images.yml pull
docker compose --env-file .env -f docker-compose.images.yml up -d

Project files stay in ./projects unless you set PODOCRACY_PROJECTS_DIR in .env.

Open GitHub README Back