Skip to content

Simplify Docker setup across desktop and homelab - #4

Merged
Bromeego merged 2 commits into
mainfrom
codex/simple-docker-setup
Jul 17, 2026
Merged

Simplify Docker setup across desktop and homelab#4
Bromeego merged 2 commits into
mainfrom
codex/simple-docker-setup

Conversation

@Bromeego

Copy link
Copy Markdown
Owner

What changed

  • use stable Docker-managed volumes by default with no required .env file
  • discover named-volume or bind-folder mounts automatically for each SimulationCraft job
  • add an optional homelab bind-folder Compose overlay
  • add Windows and macOS/Linux launchers
  • add a desktop and homelab setup guide
  • validate every Compose and local-build combination in CI

Why

The original deployment required users to calculate and repeat absolute host paths so the web container could launch SimulationCraft. Docker already knows the resolved mount sources, so the app can reuse those directly. This makes personal setup much simpler while retaining explicit host-folder storage for homelabs.

Validation

  • 20 Python tests with the project virtual environment
  • 20 Python tests inside the built Python 3.12 image
  • JavaScript interface test
  • four Compose configuration combinations
  • Docker image build
  • direct official SimulationCraft smoke test
  • real web simulation with named volumes
  • real web simulation with homelab bind folders
  • launcher startup and health wait
  • clean whitespace validation

Release plan

Publish v0.3.0-rc.1 from this branch for Windows and homelab testing before merging and promoting v0.3.0.

@Bromeego
Bromeego marked this pull request as ready for review July 17, 2026 07:55
@Bromeego
Bromeego merged commit 3acc8a2 into main Jul 17, 2026
1 check passed
@Bromeego
Bromeego deleted the codex/simple-docker-setup branch July 17, 2026 07:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant