# .env.example — template for the project's environment files. # # There are TWO kinds of env file, loaded by the Makefile in this order: # # .env → LOCAL / shared config. ALWAYS loaded. NO remote credentials. # Used by local targets (docker compose ${UID}/${GID} + the # travel-memories env_file, and `make test-post` / `make test`). # Copy the LOCAL section below into it. # # .env.test → REMOTE config for the test environment. # .env.prod → REMOTE config for production. # Loaded only when a remote target sets ENV, e.g. # `make remote-install-prod`. Copy the REMOTE section below into # each, with the values for that environment. # # .env, .env.test and .env.prod are all gitignored — never commit real values. # This .example file is the only one that IS committed; keep its values as # placeholders. # ───────────────────────────────────────────────────────────────────────────── # LOCAL → copy into .env # ───────────────────────────────────────────────────────────────────────────── # Host user/group id for container file ownership (docker-compose ${UID}:${GID}). # Match your local user: run `id -u` / `id -g` (usually 1000 on a single-user box). UID=1000 GID=1000 # Local Grav dev server. GRAV_BASE_URL is used by the Playwright suite and # scripts/test-post.sh. GRAV_BASE_URL=http://localhost:8081 # Test login for `make test` — OPTIONAL. If unset, the suite auto-creates and # uses a dedicated local-only account (testrunner / Testpass1234), gitignored so # it is never pushed to prod (see `make test-account`). Override only to test as # a different account; keep the password free of shell/Make/URL-special chars. # GRAV_TEST_USER=testrunner # GRAV_TEST_PASS=Testpass1234 GRAV_USER_DIR=/absolute/path/to/travel-blog-intotheeast/user # travel-memories service (docker-compose `env_file: .env`). Fill in whatever # that Flask app needs — e.g. its Immich connection. Leave commented until set. # IMMICH_URL= # IMMICH_API_KEY= # ───────────────────────────────────────────────────────────────────────────── # REMOTE → copy into .env.test AND .env.prod (with per-env values) # ───────────────────────────────────────────────────────────────────────────── # SSH connection to the target server. REMOTE_USER=deploy REMOTE_HOST=example.com REMOTE_PORT=22 REMOTE_HOME=/home/example.com # Server paths. Optional — default to $(REMOTE_HOME)/public_html and # $(REMOTE_HOME)/site-config. Set explicitly only if the layout differs # (e.g. a per-domain webroot like /home/deploy/domains/test.example.com/public_html). WEBROOT=/home/example.com/public_html SITE_CONFIG_DIR=/home/example.com/site-config # Grav version installed by scripts/server-install.sh (remote-install). GRAV_VERSION=2.0.4 # Repos cloned/pulled on the server. USER_REPO=https://gitea.example.com/org/intotheeast-user.git MAIN_REPO=https://gitea.example.com/org/travel-blog-intotheeast.git # Gitea credentials used by remote-install / remote-env-setup. GITEA_HOST=gitea.example.com GITEA_USER=deploy-user GITEA_TOKEN=your-gitea-personal-access-token