Skip to content
Browse the docs

Troubleshooting

View on GitHubReport a problem with this page

Something not starting, or not finishing? Start here. If your problem isn't listed, open an issue with the bug report form.

The stack#

docker compose up cannot pull ghcr.io/dante0747/archsim-app or archsim-web. Compose pulls the release images at the version the checkout names. Check that Docker reaches ghcr.io (a proxy or a firewall may block it). A commit that has just changed the version names images that its release has not published yet: run a release's own checkout (git checkout v1.0.0), or your own build.

Compose runs the release, not your change. docker-compose.yml runs the release's images. To run what you have built, add docker-compose.local.yml, as getting-started.md shows.

With docker-compose.local.yml, compose cannot find the image archsim-app:local. Compose never pulls or builds the API's local image: build it first with ./gradlew :archsim-app:jibDockerBuild (make image), and again after changing the Java code.

Back on the release's images, the worker keeps restarting: "the database is at V…, this worker needs V…". Your own build (docker-compose.local.yml, or the API run from source) migrated the database past the release, and both stacks share it (archsim_pgdata). The release's migrate leaves a newer schema alone, and its worker refuses it. Go back to your own build (make up-local), or wait for the release that carries the migration. Starting afresh, docker compose down -v, deletes the database and everything in it.

The web app says it cannot reach the API. Start the API as getting-started.md shows. If it runs elsewhere, set ARCHSIM_API_URL for the web server (default http://127.0.0.1:8000).

Runs stay queued. No worker is running: start one (make worker, or the worker role of archsim-app's jar) with the API's ARCHSIM_DATABASE_URL. With Compose, check that the worker service is up.

A worker stops with OutOfMemoryError. Its runs share its heap, and a run that exhausts it stops the worker on purpose (-XX:+ExitOnOutOfMemoryError); its runs are requeued, and failed only if their worker stops a second time. Give the worker the heap archsim-app's README asks for, or lower ARCHSIM_MAX_CONCURRENT_RUNS.

Windows#

Connections to localhost stall. With Docker Desktop on Windows, localhost may try IPv6 first and stall. Use 127.0.0.1, as the defaults do.

The CLI shows → garbled. The archsim command writes UTF-8 whatever the console's encoding; a console on a legacy code page shows it garbled. Switch the console to UTF-8 (chcp 65001) first.

Privacy#

Next.js telemetry. Neither the API nor the web app phones home, and the npm scripts and the Docker image switch off Next.js's own anonymous telemetry (NEXT_TELEMETRY_DISABLED=1) unless you set it yourself. See SECURITY.md.