Generate a chart and run locally (Windows/macOS/Linux)

Generate a chart and run locally (Windows/macOS/Linux)

This guide shows how to generate a ZIP project from the DEMO builder and run it locally with Docker.

  1. On the home page, open the DEMO builder and pick a chart type.
  2. Click Modify Chart.
  3. Fill in Series and Values. Adjust axes and options if needed.
  4. Click Generate ZIP. In the Confirm dialog, make sure your subscription is active and the ZIP counter > 0.
  5. Unzip the downloaded archive.
  6. Install and start Docker Desktop from docker.com.
  7. In the unzipped folder, run the central script:
    • Windows: double-click run-docker-windows.bat
    • macOS/Linux:
      chmod +x ./run-docker-unix.sh
      ./run-docker-unix.sh
    The scripts first try to start containers without rebuilding. If images are missing, they’ll automatically attempt to load a local base-images.tar (if present), and only then perform a one-time build when necessary.
  8. Open in your browser:
    • Frontend: http://localhost:8081/
    • Backend: http://localhost:8080/

Tip: If your plan includes an offline license, download it on Settings and place it at frontend/public/license.cwclic.

Advanced (offline, rebuild, stop)

Offline preparation (do once when online)

On any machine with Internet, run:

  • Windows: preload-base-images-windows.bat
  • macOS/Linux: ./preload-base-images-unix.sh

The script downloads base Docker images and packs them into base-images.tar. Move this file next to your project on the offline machine.

Load images offline

On the offline machine (next to docker-compose.yml):

  • Windows: load-base-images-windows.bat
  • macOS/Linux: ./load-base-images-unix.sh

Alternatively, just run the central script — it will try to load base-images.tar automatically if found.

Force rebuild (when needed)

  • Windows: run-docker-windows.bat rebuild
  • macOS/Linux: ./run-docker-unix.sh rebuild
  • or env var: CWC_REBUILD=1

Stop / clean up

  • Stop containers: stop-docker-windows.bat or ./stop-docker-unix.sh
  • Full cleanup (remove volumes) manually:
    docker compose down -v

Troubleshooting

  • Docker is not running: open Docker Desktop and try again.
  • Ports are busy: edit ports in docker-compose.yml and restart.
  • Permissions (mac/linux): run chmod +x ./run-docker-unix.sh.
  • No Internet / auth.docker.io error: use the offline flow above — prepare base-images.tar, load it with load-base-images-*, then run the central script again.