Skip to content
screenjson

screenjson-cli

Run screenjson-cli in Docker

Use the official Docker image for conversion, export, validation, and server mode without installing Go locally.

Last updated January 2026

Pull

docker pull screenjson/cli:latest

One-shot commands

# Help
docker run --rm screenjson/cli help

# Convert a local file — mount the current directory
docker run --rm -v "$PWD:/data" screenjson/cli \
  convert -i /data/screenplay.fdx -o /data/screenplay.json

# Validate
docker run --rm -v "$PWD:/data" screenjson/cli \
  validate -i /data/screenplay.json --strict

# Export to PDF with A4 paper
docker run --rm -v "$PWD:/data" screenjson/cli \
  export -i /data/screenplay.json -f pdf --pdf-paper a4 -o /data/screenplay.pdf

Server mode

docker run --rm -p 8080:8080 \
  -e SCREENJSON_GOTENBERG_URL=http://gotenberg:3000 \
  screenjson/cli serve --port 8080

Exposes /convert, /export, /validate, /formats, /health.

docker-compose example

services:
  screenjson:
    image: screenjson/cli:latest
    ports:
      - "8080:8080"
    environment:
      - SCREENJSON_GOTENBERG_URL=http://gotenberg:3000
      - SCREENJSON_PDFTOHTML=/usr/bin/pdftohtml
    command: ["serve", "--port", "8080"]

  gotenberg:
    image: gotenberg/gotenberg:8
    ports:
      - "3000:3000"

Next