Local Compiler

Run the Quickback compiler locally using Docker Desktop. This is for select users with local compiler access.

Prerequisites

Docker Desktop installed and running
Local compiler image access (contact support)

Setup

Pull and run the compiler container:

docker run -d -p 3020:3020 --name quickback-compiler ghcr.io/kardoe/quickback-compiler:latest

Usage

Point the CLI to your local compiler:

QUICKBACK_API_URL=http://localhost:3020 quickback compile

Or export it for the session:

export QUICKBACK_API_URL=http://localhost:3020
quickback compile

With API Key

If your local compiler requires authentication:

QUICKBACK_API_URL=http://localhost:3020 QUICKBACK_API_KEY=your_key quickback compile

Verify

Check the compiler is running:

curl http://localhost:3020/health

Ports

The default port is 3020. If you need a different port:

docker run -d -p 3000:3020 --name quickback-compiler ghcr.io/kardoe/quickback-compiler:latest
QUICKBACK_API_URL=http://localhost:3000 quickback compile

Troubleshooting

Container not starting

docker logs quickback-compiler

Port already in use

# Find what's using the port
lsof -i :3020

# Use a different port
docker run -d -p 3021:3020 --name quickback-compiler ghcr.io/kardoe/quickback-compiler:latest

Stop and remove

docker stop quickback-compiler
docker rm quickback-compiler

On this page