Skip to content

docs(compose): point bare 'docker compose up' at ./start.sh on first run#53

Merged
colombod merged 1 commit into
mainfrom
docs/compose-first-run-hint
Jul 9, 2026
Merged

docs(compose): point bare 'docker compose up' at ./start.sh on first run#53
colombod merged 1 commit into
mainfrom
docs/compose-first-run-hint

Conversation

@colombod

@colombod colombod commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator

On a fresh checkout, a bare docker compose up fails with a cryptic env file .../neo4j-auth.env not found because that file is generated by the documented first-run bootstrap ./start.sh. Compose can't rewrite that error text without regressing the env_file-based credential security or breaking bare docker compose up on subsequent runs, so this ties the exact error to its remedy where a confused user looks: a header comment in docker-compose.yml and a troubleshooting note in the README.

No behavior/security change; the two retained docker tests still pass.

On a fresh checkout, a bare `docker compose up` fails with a cryptic
`env file .../neo4j-auth.env not found` because that file is generated
by the documented first-run bootstrap `./start.sh`. Compose can't rewrite
that error text without regressing the env_file-based credential security
or breaking bare `docker compose up` on subsequent runs, so this ties
the exact error to its remedy where a confused user looks: a header
comment in docker-compose.yml and a troubleshooting note in the README.

No behavior/security change; the two retained docker tests still pass.

🤖 Generated with [Amplifier](https://github.com/microsoft/amplifier)

Co-Authored-By: Amplifier <240397093+microsoft-amplifier@users.noreply.github.com>
@colombod
colombod merged commit 3211be1 into main Jul 9, 2026
3 checks passed
@colombod
colombod deleted the docs/compose-first-run-hint branch July 16, 2026 02:41
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