← Back to work
Open Source · MIT License

polarion-docker

Polarion on your laptop, ready in minutes.

One build. Every version. All platforms.

Docker · OrbStack · Apple Container VS Code Integration Polarion ALM 2406+
Star on GitHub Read the blog
3
Container Runtimes
4+
Polarion Versions
VS Code
Task Integration
MIT
License

What it does

Fully Pre-Configured

PostgreSQL, WebSocket proxy, SVN aliases and memory tuning handled automatically. Drop in your Polarion ZIP, build and start.

VS Code Workspace

Bundled workspace with tasks for every action: start, stop, logs, error grep, debugger attach and hot plugin redeploy.

Integrated Debugger

JDWP debug port exposed out of the box. Attach VS Code's Java debugger and set breakpoints inside any Polarion class, live.

Mailpit Mail Catcher

Embedded Mailpit catches all outgoing Polarion notifications automatically. Inspect every email at localhost:8025.

Hot Plugin Redeploy

Deploy your plugin JAR into a running container without restarting Polarion — iteration time drops to seconds.

Apple Container Ready

Full support for macOS's native container runtime (macOS 26+) alongside Docker and OrbStack. One Dockerfile, every runtime.

Up and running in 3 steps

01

Get the ZIP

Download your Polarion ZIP from Siemens and drop it into the repo's data/ folder. The only file you supply.

02

Build

One command. Docker, OrbStack or Apple Container handles the OS layer, PostgreSQL, Java, WebSocket config and the Polarion install.

03

Start & Develop

Run the container, open VS Code and build. Attach the debugger, deploy your plugin, inspect emails — all from your editor.

Runs on your machine

One Dockerfile. Every major container runtime. Pick what's already installed.

Docker Desktop
macOS, Windows, Linux
docker build
OrbStack
Lightweight macOS alternative
docker build
Apple Container
Native macOS 26+ runtime
container build
Linux / CI
Any Docker Engine host
headless

Get building

BUILD FROM SOURCE 
# Clone and drop in your Polarion ZIP
git clone https://github.com/phillipboesger/polarion-docker
cp ~/Downloads/PolarionALM_*.zip data/

# Build & run
docker build --platform linux/amd64 -t polarion:local .
docker run -d --name polarion --memory 4g \
  -p 80:80 -p 8025:8025 -p 5433:5433 -p 5005:5005 \
  polarion:local

# Polarion: http://localhost/   Mailpit: http://localhost:8025/
APPLE CONTAINER 
# Requires macOS 26+ with Apple Container
container system start
container builder start --cpus 8 --memory 8g
container build --platform linux/amd64 -t polarion:local .

container run -d --name polarion --platform linux/amd64 --rosetta \
  --cpus 8 --memory 4g \
  -p 127.0.0.1:8080:80 -p 127.0.0.1:8025:8025 \
  polarion:local
PODMAN 
# Podman is a drop-in for Docker
podman build --platform linux/amd64 -t polarion:local .
podman run -d --name polarion --platform linux/amd64 --memory 4g -p 80:80 -p 8025:8025 -p 5433:5433 -p 5005:5005 polarion:local
# Polarion: http://localhost/   Mailpit: http://localhost:8025/
PRE-BUILT IMAGE 
# Every Polarion version ships its own image tag; :latest is the newest
docker run -d \
  --name polarion \
  --platform linux/amd64 \
  --memory 4g \
  -p 80:80 \
  -p 8025:8025 \
  -p 5433:5433 \
  -p 5005:5005 \
  -e JAVA_OPTS="-Xmx3g -Xms3g" \
  -e JDWP_ENABLED=true \
  --volume polarion_repo:/opt/polarion/data/svn \
  --volume polarion_extensions:/opt/polarion/polarion/extensions \
  ghcr.io/phillipboesger/polarion-docker:latest

The pre-built ghcr.io image bundles a licensed Polarion install and is only accessible to authorized pull accounts. Use "Build from Source" unless you already have access.

Ready to stop fighting Polarion setup?

Open-source, self-hosted, and running in minutes. Your ZIP, your machine, your data.

Star on GitHub Read the blog

Or let an AI sum me up — the prompt is already prepared:

ChatGPT Claude Perplexity Gemini