Repository navigation
docs: create .env before docker compose up in the self-hosted quickstart - #505
Merged
loveRhythm1990 merged 1 commit intoNov 18, 2026
Conversation
docker compose up -d fails with 'required variable MEMORIA_MASTER_KEY is missing a value' because the quickstart never mentions .env. Add the cp .env.example .env step with the master key hint, and point the compose error message at .env.example too.
loveRhythm1990
requested review from
XuPeng-SH,
aptend and
gouhongshen
as code owners
November 17, 2026 12:33
Contributor
|
This pull request is merged. |
gouhongshen
approved these changes
Nov 18, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #18
Problem
The self-hosted quickstart in the README goes straight from
git clonetodocker compose up -d. The compose file requiresMEMORIA_MASTER_KEY, so a first-time user gets:The repo has a
.env.example, but nothing in the quickstart or in the error points to it.skills/deployment/SKILL.mdalready documents thecp .env.example .envstep. The README does not.Change
README.md: addcp .env.example .envand a note to setMEMORIA_MASTER_KEY(min 16 chars, for exampleopenssl rand -hex 32) and the embedding settings beforedocker compose up -d.docker-compose.yml: extend the required-variable message withstart from cp .env.example .env. The text avoids:because it sits inside a YAML list item, where a colon followed by a space is parsed as a mapping.Verification
.envfile,docker compose configfails and the message now includes the hint.cp .env.example .env,docker compose configsucceeds and rendersMASTER_KEY.Notes
.env.exampleshipsMEMORIA_MASTER_KEY=your-master-key-here. That placeholder is 20 characters, so it passes the length check silently. The README now tells users to replace it. Rejecting the placeholder in the compose file would be a separate change.