Skip to content

v1.7.0: one-command install with Docker, setup scripts for Mac and Linux - #48

Merged
simonro merged 1 commit into
mainfrom
feat/one-command-install
Nov 8, 2026
Merged

simonro merged 1 commit into
mainfrom
feat/one-command-install

Conversation

@simonro

@simonro simonro commented Nov 8, 2026

Copy link
Copy Markdown
Owner

What

Two ways to install, both one step:

  • Docker: docker compose up -d, then open http://localhost:3010. No Python or Node needed.
  • Setup script: setup.bat / launch.bat on Windows (unchanged), and new setup.sh / launch.sh for Mac and Linux.

Docker details

  • Everything the journal writes (database, its pre-delete backups, uploads, update-check cache) goes to /data, kept in the journal-data volume. git pull + docker compose up -d --build never touches it.
  • The data paths are pinned in docker-compose.yml, so a DATABASE_PATH left in backend/.env from a local install cannot move trades into the disposable container layer.
  • Both ports bind to 127.0.0.1 (the journal has no login). Backend runs as uid 10001, frontend on nginx-unprivileged.
  • .dockerignore keeps .env, .env.*, databases, uploads and node_modules out of every image.
  • backend/.env is optional (env_file required: false, Compose 2.24+).
  • The update notice shows Docker steps when it runs in the container (install: "docker" in /api/update).

Tested

  • Fresh clone: both images build, stack comes up healthy, the sample Thinkorswim statement imports 4 trades, data survives down + up, backup command copies database and uploads.
  • Hostile backend/.env (DATABASE_PATH=/tmp/x.db) is ignored; backend/.env.local does not reach the image.
  • setup.sh and launch.sh on clean Debian (Python 3.12, distro Node): setup runs twice safely, both servers answer, Ctrl+C on the process group stops both.
  • Backend 345 passed, frontend 93 passed (Node 24 container).
  • New CI job Docker Install repeats the build, import and restart checks on every PR.

Not tested: macOS itself (scripts avoid bash 4 features), Docker on Apple Silicon.

ChatGPT-reviewed (1 pass, 6 findings, all fixed).

🤖 Generated with Claude Code

- docker compose up -d runs the whole journal with no Python or Node on the machine. The database,
  its backups, uploads and the update-check cache live in the journal-data volume; both ports bind
  to 127.0.0.1; both containers run as non-root users; secrets and databases never enter an image.
- setup.sh and launch.sh mirror setup.bat and launch.bat. Ctrl+C stops both servers and the dev
  server stays on 127.0.0.1.
- The update notice shows Docker update steps inside the container.
- CI builds the images, imports the sample statement and checks the data survives a restart.
- README quick start rewritten around the two options.

ChatGPT-reviewed (1 pass).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@simonro
simonro merged commit 7371115 into main Nov 8, 2026
3 checks passed
@simonro
simonro deleted the feat/one-command-install branch November 8, 2026 13:33
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.

2 participants