A Docker image to run a Highcharts export server using node-export-server.

• Multi-architecture support (amd64, arm64)
• Runs as non-root user for security
• Persistent caching for improved performance
• Configurable worker pool for memory optimization

• Docker 20.10+

docker run -d \
    --name highcharts-export \
    -v highcharts-cache:/cache \
    --cap-add=SYS_ADMIN \
    -p 7801:7801 \
    ghcr.io/interactive-studios/dockerized-highcharts-export-server

The server is now available at http://localhost:7801.

services:
  highcharts:
    image: ghcr.io/interactive-studios/dockerized-highcharts-export-server
    restart: unless-stopped
    volumes:
      - highcharts-cache:/cache
    ports:
      - 7801:7801
    cap_add:
      - SYS_ADMIN
    environment:
      - POOL_MIN_WORKERS=1
      - POOL_MAX_WORKERS=4

volumes:
  highcharts-cache:

curl \
    -H "Content-Type: application/json" \
    -X POST \
    -d '{"infile":{"title": {"text": "Steep Chart"}, "xAxis": {"categories": ["Jan", "Feb", "Mar"]}, "series": [{"data": [29.9, 71.5, 106.4]}]}}' \
    localhost:7801 \
    -o chart.png

Specify the output format using the type parameter:

# PNG (default)
curl -X POST -H "Content-Type: application/json" \
    -d '{"type": "png", "infile": {...}}' \
    localhost:7801 -o chart.png

# SVG
curl -X POST -H "Content-Type: application/json" \
    -d '{"type": "svg", "infile": {...}}' \
    localhost:7801 -o chart.svg

# PDF
curl -X POST -H "Content-Type: application/json" \
    -d '{"type": "pdf", "infile": {...}}' \
    localhost:7801 -o chart.pdf

Adjust worker pool size based on your workload and available memory:

docker run -d \
    -e POOL_MIN_WORKERS=2 \
    -e POOL_MAX_WORKERS=8 \
    -v highcharts-cache:/cache \
    --cap-add=SYS_ADMIN \
    -p 7801:7801 \
    ghcr.io/interactive-studios/dockerized-highcharts-export-server

Memory guidelines:

• Each worker uses approximately 100-200 MB of memory
• For 1 GB available: use 2-4 workers
• For 2 GB available: use 4-8 workers
• For 4 GB+ available: use 8-16 workers

For production deployments, set resource limits:

services:
  highcharts:
    image: ghcr.io/interactive-studios/dockerized-highcharts-export-server
    deploy:
      resources:
        limits:
          memory: 2G
        reservations:
          memory: 512M
    # ... other settings

The SYS_ADMIN capability is required for Chromium's sandboxing features. Without it, Chromium cannot create the necessary namespaces for process isolation.

For environments where SYS_ADMIN is not available, you can disable the sandbox (not recommended for production):

docker run -d \
    -e PUPPETEER_ARGS="--no-sandbox --disable-setuid-sandbox" \
    -v highcharts-cache:/cache \
    -p 7801:7801 \
    ghcr.io/interactive-studios/dockerized-highcharts-export-server

The server runs as a non-root highcharts user inside the container for improved security.

1. Ensure Docker has enough memory allocated (minimum 512 MB)
2. Verify the SYS_ADMIN capability is added
3. Check logs: docker logs <container-id>

• Reduce POOL_MAX_WORKERS value
• Increase Docker memory limits
• Monitor memory usage: docker stats <container-id>

• Increase POOL_MIN_WORKERS to keep workers warm
• Ensure the cache volume is mounted for persistent caching
• Check if the container has sufficient CPU resources

• Verify the cache volume has correct permissions
• The container runs as UID 1000 (highcharts user)

For full API documentation, see the node-export-server documentation.

Common request parameters:

This project is licensed under the MIT License. See the LICENSE file for details.

When running this image, you're automatically accepting the Highcharts license terms.