admin/changemaker.lite
1
0
Fork 0
Code Issues Packages Projects Releases 31 Wiki Activity
changemaker.lite/mkdocs/site/v2/deployment/environment-variables/index.html

7144 lines
158 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="description" content="Build Power. Not Rent It. Own your digital infrastructure.">
<meta name="author" content="Bunker Operations">
<link rel="canonical" href="https://bnkserve.org/v2/deployment/environment-variables/">
<link rel="prev" href="../docker-compose/">
<link rel="next" href="../nginx/">
<link rel="icon" href="../../../assets/favicon.png">
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.1">
<title>Environment Variables - Changemaker Lite</title>
<link rel="stylesheet" href="../../../assets/stylesheets/main.484c7ddc.min.css">
<link rel="stylesheet" href="../../../assets/stylesheets/palette.ab4e12ef.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Inter:300,300i,400,400i,700,700i%7CJetBrains+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"Inter";--md-code-font:"JetBrains Mono"}</style>
<link rel="stylesheet" href="../../../stylesheets/extra.css">
<link rel="stylesheet" href="../../../stylesheets/home.css">
<link rel="stylesheet" href="../../../assets/css/video-player.css">
<script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
<meta property="og:type" content="website" />
<meta property="og:title" content="Environment Variables - Changemaker Lite" />
<meta property="og:description" content="Build Power. Not Rent It. Own your digital infrastructure." />
<meta property="og:image" content="https://bnkserve.org/assets/images/social/v2/deployment/environment-variables.png" />
<meta property="og:image:type" content="image/png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:url" content="https://bnkserve.org/v2/deployment/environment-variables/" />
<meta property="twitter:card" content="summary_large_image" />
<meta property="twitter:title" content="Environment Variables - Changemaker Lite" />
<meta property="twitter:description" content="Build Power. Not Rent It. Own your digital infrastructure." />
<meta property="twitter:image" content="https://bnkserve.org/assets/images/social/v2/deployment/environment-variables.png" />
</head>
<body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="deep-purple" data-md-color-accent="amber">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#environment-variables-reference" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header md-header--shadow md-header--lifted" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href="../../.." title="Changemaker Lite" class="md-header__button md-logo" aria-label="Changemaker Lite" data-md-component="logo">
<img src="../../../assets/logo.png" alt="logo">
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
Changemaker Lite
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
Environment Variables
</span>
</div>
</div>
</div>
<form class="md-header__option" data-md-component="palette">
<input class="md-option" data-md-color-media="" data-md-color-scheme="slate" data-md-color-primary="deep-purple" data-md-color-accent="amber" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m17.75 4.09-2.53 1.94.91 3.06-2.63-1.81-2.63 1.81.91-3.06-2.53-1.94L12.44 4l1.06-3 1.06 3zm3.5 6.91-1.64 1.25.59 1.98-1.7-1.17-1.7 1.17.59-1.98L15.75 11l2.06-.05L18.5 9l.69 1.95zm-2.28 4.95c.83-.08 1.72 1.1 1.19 1.85-.32.45-.66.87-1.08 1.27C15.17 23 8.84 23 4.94 19.07c-3.91-3.9-3.91-10.24 0-14.14.4-.4.82-.76 1.27-1.08.75-.53 1.93.36 1.85 1.19-.27 2.86.69 5.83 2.89 8.02a9.96 9.96 0 0 0 8.02 2.89m-1.64 2.02a12.08 12.08 0 0 1-7.8-3.47c-2.17-2.19-3.33-5-3.49-7.82-2.81 3.14-2.7 7.96.31 10.98 3.02 3.01 7.84 3.12 10.98.31"/></svg>
</label>
<input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="amber" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 7a5 5 0 0 1 5 5 5 5 0 0 1-5 5 5 5 0 0 1-5-5 5 5 0 0 1 5-5m0 2a3 3 0 0 0-3 3 3 3 0 0 0 3 3 3 3 0 0 0 3-3 3 3 0 0 0-3-3m0-7 2.39 3.42C13.65 5.15 12.84 5 12 5s-1.65.15-2.39.42zM3.34 7l4.16-.35A7.2 7.2 0 0 0 5.94 8.5c-.44.74-.69 1.5-.83 2.29zm.02 10 1.76-3.77a7.131 7.131 0 0 0 2.38 4.14zM20.65 7l-1.77 3.79a7.02 7.02 0 0 0-2.38-4.15zm-.01 10-4.14.36c.59-.51 1.12-1.14 1.54-1.86.42-.73.69-1.5.83-2.29zM12 22l-2.41-3.44c.74.27 1.55.44 2.41.44.82 0 1.63-.17 2.37-.44z"/></svg>
</label>
</form>
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
</a>
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
</button>
</nav>
<div class="md-search__suggest" data-md-component="search-suggest"></div>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
<div class="md-header__source">
<a href="https://gitea.bnkops.com/admin/changemaker.lite" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
</div>
<div class="md-source__repository">
changemaker.lite
</div>
</a>
</div>
</nav>
<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
<div class="md-grid">
<ul class="md-tabs__list">
<li class="md-tabs__item">
<a href="../../.." class="md-tabs__link">
Home
</a>
</li>
<li class="md-tabs__item md-tabs__item--active">
<a href="../../" class="md-tabs__link">
V2 Documentation
</a>
</li>
<li class="md-tabs__item">
<a href="../../../phil/" class="md-tabs__link">
Philosophy
</a>
</li>
<li class="md-tabs__item">
<a href="../../../v1/" class="md-tabs__link">
V1 Documentation (Legacy)
</a>
</li>
<li class="md-tabs__item">
<a href="../../../blog/" class="md-tabs__link">
Blog
</a>
</li>
</ul>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href="../../.." title="Changemaker Lite" class="md-nav__button md-logo" aria-label="Changemaker Lite" data-md-component="logo">
<img src="../../../assets/logo.png" alt="logo">
</a>
Changemaker Lite
</label>
<div class="md-nav__source">
<a href="https://gitea.bnkops.com/admin/changemaker.lite" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
</div>
<div class="md-source__repository">
changemaker.lite
</div>
</a>
</div>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../.." class="md-nav__link">
<span class="md-ellipsis">
Home
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
<div class="md-nav__link md-nav__container">
<a href="../../" class="md-nav__link ">
<span class="md-ellipsis">
V2 Documentation
</span>
</a>
<label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_2">
<span class="md-nav__icon md-icon"></span>
V2 Documentation
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_2" >
<div class="md-nav__link md-nav__container">
<a href="../../getting-started/" class="md-nav__link ">
<span class="md-ellipsis">
Getting Started
</span>
</a>
<label class="md-nav__link " for="__nav_2_2" id="__nav_2_2_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_2">
<span class="md-nav__icon md-icon"></span>
Getting Started
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../getting-started/quick-start/" class="md-nav__link">
<span class="md-ellipsis">
Quick Start
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_3" >
<div class="md-nav__link md-nav__container">
<a href="../../architecture/" class="md-nav__link ">
<span class="md-ellipsis">
Architecture
</span>
</a>
<label class="md-nav__link " for="__nav_2_3" id="__nav_2_3_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_3_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_3">
<span class="md-nav__icon md-icon"></span>
Architecture
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../architecture/dual-api/" class="md-nav__link">
<span class="md-ellipsis">
Dual API System
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../architecture/authentication/" class="md-nav__link">
<span class="md-ellipsis">
Authentication & Security
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_4" >
<div class="md-nav__link md-nav__container">
<a href="../../backend/" class="md-nav__link ">
<span class="md-ellipsis">
Backend
</span>
</a>
<label class="md-nav__link " for="__nav_2_4" id="__nav_2_4_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_4_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_4">
<span class="md-nav__icon md-icon"></span>
Backend
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../backend/modules/" class="md-nav__link">
<span class="md-ellipsis">
Modules
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../backend/services/" class="md-nav__link">
<span class="md-ellipsis">
Services
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../backend/middleware/" class="md-nav__link">
<span class="md-ellipsis">
Middleware
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../backend/utilities/" class="md-nav__link">
<span class="md-ellipsis">
Utilities
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_5" >
<div class="md-nav__link md-nav__container">
<a href="../../frontend/" class="md-nav__link ">
<span class="md-ellipsis">
Frontend
</span>
</a>
<label class="md-nav__link " for="__nav_2_5" id="__nav_2_5_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_5_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_5">
<span class="md-nav__icon md-icon"></span>
Frontend
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../frontend/components/" class="md-nav__link">
<span class="md-ellipsis">
Components
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../frontend/layouts/" class="md-nav__link">
<span class="md-ellipsis">
Layouts
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../frontend/pages/" class="md-nav__link">
<span class="md-ellipsis">
Pages
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_6" >
<div class="md-nav__link md-nav__container">
<a href="../../database/" class="md-nav__link ">
<span class="md-ellipsis">
Database
</span>
</a>
<label class="md-nav__link " for="__nav_2_6" id="__nav_2_6_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_6_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_6">
<span class="md-nav__icon md-icon"></span>
Database
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../database/schema/" class="md-nav__link">
<span class="md-ellipsis">
Schema Overview
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../database/migrations/" class="md-nav__link">
<span class="md-ellipsis">
Migrations
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../database/seeding/" class="md-nav__link">
<span class="md-ellipsis">
Seeding
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../database/indexes/" class="md-nav__link">
<span class="md-ellipsis">
Indexes
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../database/models/" class="md-nav__link">
<span class="md-ellipsis">
Models
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_7" >
<div class="md-nav__link md-nav__container">
<a href="../../features/" class="md-nav__link ">
<span class="md-ellipsis">
Features
</span>
</a>
<label class="md-nav__link " for="__nav_2_7" id="__nav_2_7_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_7_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_7">
<span class="md-nav__icon md-icon"></span>
Features
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../features/influence/" class="md-nav__link">
<span class="md-ellipsis">
Influence
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../features/map/" class="md-nav__link">
<span class="md-ellipsis">
Map
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../features/landing-pages/" class="md-nav__link">
<span class="md-ellipsis">
Landing Pages
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../features/email-templates/" class="md-nav__link">
<span class="md-ellipsis">
Email Templates
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../features/media/" class="md-nav__link">
<span class="md-ellipsis">
Media
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../features/newsletter/" class="md-nav__link">
<span class="md-ellipsis">
Newsletter
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../features/observability/" class="md-nav__link">
<span class="md-ellipsis">
Observability
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../features/tunnel/" class="md-nav__link">
<span class="md-ellipsis">
Tunnel
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8" checked>
<div class="md-nav__link md-nav__container">
<a href="../" class="md-nav__link ">
<span class="md-ellipsis">
Deployment
</span>
</a>
<label class="md-nav__link " for="__nav_2_8" id="__nav_2_8_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_8_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_2_8">
<span class="md-nav__icon md-icon"></span>
Deployment
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../docker-compose/" class="md-nav__link">
<span class="md-ellipsis">
Docker Compose
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
Environment Variables
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
<span class="md-ellipsis">
Environment Variables
</span>
</a>
<nav class="md-nav md-nav--secondary" aria-label="On this page">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
On this page
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#overview" class="md-nav__link">
<span class="md-ellipsis">
Overview
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#quick-start" class="md-nav__link">
<span class="md-ellipsis">
Quick Start
</span>
</a>
<nav class="md-nav" aria-label="Quick Start">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#initial-setup" class="md-nav__link">
<span class="md-ellipsis">
Initial Setup
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#minimal-required-variables" class="md-nav__link">
<span class="md-ellipsis">
Minimal Required Variables
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#general-configuration" class="md-nav__link">
<span class="md-ellipsis">
General Configuration
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#v2-postgresql" class="md-nav__link">
<span class="md-ellipsis">
V2 PostgreSQL
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#jwt-authentication" class="md-nav__link">
<span class="md-ellipsis">
JWT Authentication
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#redis" class="md-nav__link">
<span class="md-ellipsis">
Redis
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#api-configuration" class="md-nav__link">
<span class="md-ellipsis">
API Configuration
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#admin-gui" class="md-nav__link">
<span class="md-ellipsis">
Admin GUI
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#nginx" class="md-nav__link">
<span class="md-ellipsis">
Nginx
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#smtp-email" class="md-nav__link">
<span class="md-ellipsis">
SMTP / Email
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#listmonk" class="md-nav__link">
<span class="md-ellipsis">
Listmonk
</span>
</a>
<nav class="md-nav" aria-label="Listmonk">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#database" class="md-nav__link">
<span class="md-ellipsis">
Database
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#web-admin" class="md-nav__link">
<span class="md-ellipsis">
Web Admin
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#api-integration" class="md-nav__link">
<span class="md-ellipsis">
API Integration
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#smtp-configuration" class="md-nav__link">
<span class="md-ellipsis">
SMTP Configuration
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#represent-api" class="md-nav__link">
<span class="md-ellipsis">
Represent API
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#nocodb" class="md-nav__link">
<span class="md-ellipsis">
NocoDB
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#media-management" class="md-nav__link">
<span class="md-ellipsis">
Media Management
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#gitea" class="md-nav__link">
<span class="md-ellipsis">
Gitea
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#n8n" class="md-nav__link">
<span class="md-ellipsis">
n8n
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#mkdocs" class="md-nav__link">
<span class="md-ellipsis">
MkDocs
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#code-server" class="md-nav__link">
<span class="md-ellipsis">
Code Server
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#homepage" class="md-nav__link">
<span class="md-ellipsis">
Homepage
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#mini-qr" class="md-nav__link">
<span class="md-ellipsis">
Mini QR
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#mailhog" class="md-nav__link">
<span class="md-ellipsis">
MailHog
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#nar-import" class="md-nav__link">
<span class="md-ellipsis">
NAR Import
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#geocoding" class="md-nav__link">
<span class="md-ellipsis">
Geocoding
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#pangolin-tunnel" class="md-nav__link">
<span class="md-ellipsis">
Pangolin Tunnel
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#monitoring" class="md-nav__link">
<span class="md-ellipsis">
Monitoring
</span>
</a>
<nav class="md-nav" aria-label="Monitoring">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#prometheus" class="md-nav__link">
<span class="md-ellipsis">
Prometheus
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#grafana" class="md-nav__link">
<span class="md-ellipsis">
Grafana
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#exporters" class="md-nav__link">
<span class="md-ellipsis">
Exporters
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#alertmanager" class="md-nav__link">
<span class="md-ellipsis">
Alertmanager
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#gotify" class="md-nav__link">
<span class="md-ellipsis">
Gotify
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#security-checklist" class="md-nav__link">
<span class="md-ellipsis">
Security Checklist
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#troubleshooting" class="md-nav__link">
<span class="md-ellipsis">
Troubleshooting
</span>
</a>
<nav class="md-nav" aria-label="Troubleshooting">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#missing-env-file" class="md-nav__link">
<span class="md-ellipsis">
Missing .env File
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#invalid-environment-variables" class="md-nav__link">
<span class="md-ellipsis">
Invalid Environment Variables
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#postgresql-connection-failures" class="md-nav__link">
<span class="md-ellipsis">
PostgreSQL Connection Failures
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#redis-connection-failures" class="md-nav__link">
<span class="md-ellipsis">
Redis Connection Failures
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#environment-variables-not-updating" class="md-nav__link">
<span class="md-ellipsis">
Environment Variables Not Updating
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#related-documentation" class="md-nav__link">
<span class="md-ellipsis">
Related Documentation
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../nginx/" class="md-nav__link">
<span class="md-ellipsis">
Nginx Configuration
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../ssl-tls/" class="md-nav__link">
<span class="md-ellipsis">
SSL/TLS
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../tunneling/" class="md-nav__link">
<span class="md-ellipsis">
Tunneling
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../monitoring-stack/" class="md-nav__link">
<span class="md-ellipsis">
Monitoring Stack
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../healthchecks/" class="md-nav__link">
<span class="md-ellipsis">
Health Checks
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../scaling/" class="md-nav__link">
<span class="md-ellipsis">
Scaling
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../backup-restore/" class="md-nav__link">
<span class="md-ellipsis">
Backup & Restore
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_9" >
<div class="md-nav__link md-nav__container">
<a href="../../development/" class="md-nav__link ">
<span class="md-ellipsis">
Development
</span>
</a>
<label class="md-nav__link " for="__nav_2_9" id="__nav_2_9_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_9_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_9">
<span class="md-nav__icon md-icon"></span>
Development
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../development/local-setup/" class="md-nav__link">
<span class="md-ellipsis">
Local Setup
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../development/docker-workflow/" class="md-nav__link">
<span class="md-ellipsis">
Docker Workflow
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../development/git-workflow/" class="md-nav__link">
<span class="md-ellipsis">
Git Workflow
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../development/npm-commands/" class="md-nav__link">
<span class="md-ellipsis">
NPM Commands
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../development/migrations/" class="md-nav__link">
<span class="md-ellipsis">
Migrations
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../development/typescript/" class="md-nav__link">
<span class="md-ellipsis">
TypeScript
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../development/testing/" class="md-nav__link">
<span class="md-ellipsis">
Testing
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../development/debugging/" class="md-nav__link">
<span class="md-ellipsis">
Debugging
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../development/code-style/" class="md-nav__link">
<span class="md-ellipsis">
Code Style
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_10" >
<div class="md-nav__link md-nav__container">
<a href="../../api-reference/" class="md-nav__link ">
<span class="md-ellipsis">
API Reference
</span>
</a>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_10_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_10">
<span class="md-nav__icon md-icon"></span>
API Reference
</label>
<ul class="md-nav__list" data-md-scrollfix>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_11" >
<div class="md-nav__link md-nav__container">
<a href="../../user-guides/" class="md-nav__link ">
<span class="md-ellipsis">
User Guides
</span>
</a>
<label class="md-nav__link " for="__nav_2_11" id="__nav_2_11_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_11_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_11">
<span class="md-nav__icon md-icon"></span>
User Guides
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../user-guides/admin-guide/" class="md-nav__link">
<span class="md-ellipsis">
Admin Guide
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../user-guides/campaign-manager-guide/" class="md-nav__link">
<span class="md-ellipsis">
Campaign Manager Guide
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../user-guides/map-organizer-guide/" class="md-nav__link">
<span class="md-ellipsis">
Map Organizer Guide
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../user-guides/content-editor-guide/" class="md-nav__link">
<span class="md-ellipsis">
Content Editor Guide
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../user-guides/volunteer-guide/" class="md-nav__link">
<span class="md-ellipsis">
Volunteer Guide
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_12" >
<div class="md-nav__link md-nav__container">
<a href="../../troubleshooting/" class="md-nav__link ">
<span class="md-ellipsis">
Troubleshooting
</span>
</a>
<label class="md-nav__link " for="__nav_2_12" id="__nav_2_12_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_12_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_12">
<span class="md-nav__icon md-icon"></span>
Troubleshooting
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../troubleshooting/faq/" class="md-nav__link">
<span class="md-ellipsis">
FAQ
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../troubleshooting/common-errors/" class="md-nav__link">
<span class="md-ellipsis">
Common Errors
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../troubleshooting/auth-issues/" class="md-nav__link">
<span class="md-ellipsis">
Auth Issues
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../troubleshooting/database-issues/" class="md-nav__link">
<span class="md-ellipsis">
Database Issues
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../troubleshooting/docker-issues/" class="md-nav__link">
<span class="md-ellipsis">
Docker Issues
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../troubleshooting/email-issues/" class="md-nav__link">
<span class="md-ellipsis">
Email Issues
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../troubleshooting/geocoding-issues/" class="md-nav__link">
<span class="md-ellipsis">
Geocoding Issues
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../troubleshooting/monitoring-issues/" class="md-nav__link">
<span class="md-ellipsis">
Monitoring Issues
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../troubleshooting/performance-optimization/" class="md-nav__link">
<span class="md-ellipsis">
Performance Optimization
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_13" >
<div class="md-nav__link md-nav__container">
<a href="../../migration/" class="md-nav__link ">
<span class="md-ellipsis">
Migration
</span>
</a>
<label class="md-nav__link " for="__nav_2_13" id="__nav_2_13_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_13_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_13">
<span class="md-nav__icon md-icon"></span>
Migration
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../migration/feature-parity/" class="md-nav__link">
<span class="md-ellipsis">
Feature Parity
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../migration/breaking-changes/" class="md-nav__link">
<span class="md-ellipsis">
Breaking Changes
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../migration/api-changes/" class="md-nav__link">
<span class="md-ellipsis">
API Changes
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../migration/data-migration/" class="md-nav__link">
<span class="md-ellipsis">
Data Migration
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_14" >
<div class="md-nav__link md-nav__container">
<a href="../../contributing/" class="md-nav__link ">
<span class="md-ellipsis">
Contributing
</span>
</a>
<label class="md-nav__link " for="__nav_2_14" id="__nav_2_14_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_14_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2_14">
<span class="md-nav__icon md-icon"></span>
Contributing
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../contributing/development-setup/" class="md-nav__link">
<span class="md-ellipsis">
Development Setup
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../contributing/code-of-conduct/" class="md-nav__link">
<span class="md-ellipsis">
Code of Conduct
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../contributing/pull-requests/" class="md-nav__link">
<span class="md-ellipsis">
Pull Requests
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../contributing/roadmap/" class="md-nav__link">
<span class="md-ellipsis">
Roadmap
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../phil/" class="md-nav__link">
<span class="md-ellipsis">
Philosophy
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../v1/" class="md-nav__link">
<span class="md-ellipsis">
V1 Documentation (Legacy)
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../blog/" class="md-nav__link">
<span class="md-ellipsis">
Blog
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary" aria-label="On this page">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
On this page
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#overview" class="md-nav__link">
<span class="md-ellipsis">
Overview
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#quick-start" class="md-nav__link">
<span class="md-ellipsis">
Quick Start
</span>
</a>
<nav class="md-nav" aria-label="Quick Start">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#initial-setup" class="md-nav__link">
<span class="md-ellipsis">
Initial Setup
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#minimal-required-variables" class="md-nav__link">
<span class="md-ellipsis">
Minimal Required Variables
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#general-configuration" class="md-nav__link">
<span class="md-ellipsis">
General Configuration
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#v2-postgresql" class="md-nav__link">
<span class="md-ellipsis">
V2 PostgreSQL
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#jwt-authentication" class="md-nav__link">
<span class="md-ellipsis">
JWT Authentication
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#redis" class="md-nav__link">
<span class="md-ellipsis">
Redis
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#api-configuration" class="md-nav__link">
<span class="md-ellipsis">
API Configuration
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#admin-gui" class="md-nav__link">
<span class="md-ellipsis">
Admin GUI
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#nginx" class="md-nav__link">
<span class="md-ellipsis">
Nginx
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#smtp-email" class="md-nav__link">
<span class="md-ellipsis">
SMTP / Email
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#listmonk" class="md-nav__link">
<span class="md-ellipsis">
Listmonk
</span>
</a>
<nav class="md-nav" aria-label="Listmonk">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#database" class="md-nav__link">
<span class="md-ellipsis">
Database
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#web-admin" class="md-nav__link">
<span class="md-ellipsis">
Web Admin
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#api-integration" class="md-nav__link">
<span class="md-ellipsis">
API Integration
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#smtp-configuration" class="md-nav__link">
<span class="md-ellipsis">
SMTP Configuration
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#represent-api" class="md-nav__link">
<span class="md-ellipsis">
Represent API
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#nocodb" class="md-nav__link">
<span class="md-ellipsis">
NocoDB
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#media-management" class="md-nav__link">
<span class="md-ellipsis">
Media Management
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#gitea" class="md-nav__link">
<span class="md-ellipsis">
Gitea
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#n8n" class="md-nav__link">
<span class="md-ellipsis">
n8n
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#mkdocs" class="md-nav__link">
<span class="md-ellipsis">
MkDocs
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#code-server" class="md-nav__link">
<span class="md-ellipsis">
Code Server
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#homepage" class="md-nav__link">
<span class="md-ellipsis">
Homepage
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#mini-qr" class="md-nav__link">
<span class="md-ellipsis">
Mini QR
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#mailhog" class="md-nav__link">
<span class="md-ellipsis">
MailHog
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#nar-import" class="md-nav__link">
<span class="md-ellipsis">
NAR Import
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#geocoding" class="md-nav__link">
<span class="md-ellipsis">
Geocoding
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#pangolin-tunnel" class="md-nav__link">
<span class="md-ellipsis">
Pangolin Tunnel
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#monitoring" class="md-nav__link">
<span class="md-ellipsis">
Monitoring
</span>
</a>
<nav class="md-nav" aria-label="Monitoring">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#prometheus" class="md-nav__link">
<span class="md-ellipsis">
Prometheus
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#grafana" class="md-nav__link">
<span class="md-ellipsis">
Grafana
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#exporters" class="md-nav__link">
<span class="md-ellipsis">
Exporters
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#alertmanager" class="md-nav__link">
<span class="md-ellipsis">
Alertmanager
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#gotify" class="md-nav__link">
<span class="md-ellipsis">
Gotify
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#security-checklist" class="md-nav__link">
<span class="md-ellipsis">
Security Checklist
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#troubleshooting" class="md-nav__link">
<span class="md-ellipsis">
Troubleshooting
</span>
</a>
<nav class="md-nav" aria-label="Troubleshooting">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#missing-env-file" class="md-nav__link">
<span class="md-ellipsis">
Missing .env File
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#invalid-environment-variables" class="md-nav__link">
<span class="md-ellipsis">
Invalid Environment Variables
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#postgresql-connection-failures" class="md-nav__link">
<span class="md-ellipsis">
PostgreSQL Connection Failures
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#redis-connection-failures" class="md-nav__link">
<span class="md-ellipsis">
Redis Connection Failures
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#environment-variables-not-updating" class="md-nav__link">
<span class="md-ellipsis">
Environment Variables Not Updating
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#related-documentation" class="md-nav__link">
<span class="md-ellipsis">
Related Documentation
</span>
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<nav class="md-path" aria-label="Navigation" >
<ol class="md-path__list">
<li class="md-path__item">
<a href="../../.." class="md-path__link">
<span class="md-ellipsis">
Home
</span>
</a>
</li>
<li class="md-path__item">
<a href="../../" class="md-path__link">
<span class="md-ellipsis">
V2 Documentation
</span>
</a>
</li>
<li class="md-path__item">
<a href="../" class="md-path__link">
<span class="md-ellipsis">
Deployment
</span>
</a>
</li>
</ol>
</nav>
<article class="md-content__inner md-typeset">
<a href="https://gitea.bnkops.com/admin/changemaker.lite/src/branch/main/mkdocs/docs/v2/deployment/environment-variables.md" title="Edit this page" class="md-content__button md-icon" rel="edit">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg>
</a>
<a href="https://gitea.bnkops.com/admin/changemaker.lite/src/branch/main/mkdocs/docs/v2/deployment/environment-variables.md" title="View source of this page" class="md-content__button md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 18c.56 0 1 .44 1 1s-.44 1-1 1-1-.44-1-1 .44-1 1-1m0-3c-2.73 0-5.06 1.66-6 4 .94 2.34 3.27 4 6 4s5.06-1.66 6-4c-.94-2.34-3.27-4-6-4m0 6.5a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5M9.27 20H6V4h7v5h5v4.07c.7.08 1.36.25 2 .49V8l-6-6H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h4.5a8.2 8.2 0 0 1-1.23-2"/></svg>
</a>
<h1 id="environment-variables-reference">Environment Variables Reference<a class="headerlink" href="#environment-variables-reference" title="Permanent link">&para;</a></h1>
<h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
<p>Changemaker Lite V2 uses over 100 environment variables to configure services, credentials, and feature flags. This document provides a complete reference organized by functional area.</p>
<p><strong>Configuration File</strong>: <code>.env</code> (never committed to Git)</p>
<p><strong>Template</strong>: <code>.env.example</code> (committed, safe to share)</p>
<p><strong>Validation</strong>: <code>api/src/config/env.ts</code> (Zod schema validates all variables on startup)</p>
<hr />
<h2 id="quick-start">Quick Start<a class="headerlink" href="#quick-start" title="Permanent link">&para;</a></h2>
<h3 id="initial-setup">Initial Setup<a class="headerlink" href="#initial-setup" title="Permanent link">&para;</a></h3>
<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="c1"># Copy template</span>
</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>cp<span class="w"> </span>.env.example<span class="w"> </span>.env
</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>
</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="c1"># Generate secrets</span>
</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>openssl<span class="w"> </span>rand<span class="w"> </span>-hex<span class="w"> </span><span class="m">32</span><span class="w"> </span><span class="c1"># For JWT_ACCESS_SECRET</span>
</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>openssl<span class="w"> </span>rand<span class="w"> </span>-hex<span class="w"> </span><span class="m">32</span><span class="w"> </span><span class="c1"># For JWT_REFRESH_SECRET</span>
</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>openssl<span class="w"> </span>rand<span class="w"> </span>-hex<span class="w"> </span><span class="m">32</span><span class="w"> </span><span class="c1"># For ENCRYPTION_KEY (must differ from JWT secrets!)</span>
</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>openssl<span class="w"> </span>rand<span class="w"> </span>-hex<span class="w"> </span><span class="m">16</span><span class="w"> </span><span class="c1"># For LISTMONK_API_TOKEN</span>
</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>
</span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="c1"># Edit .env</span>
</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>nano<span class="w"> </span>.env
</span></code></pre></div>
<h3 id="minimal-required-variables">Minimal Required Variables<a class="headerlink" href="#minimal-required-variables" title="Permanent link">&para;</a></h3>
<p><strong>Must set before first start</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nv">V2_POSTGRES_PASSWORD</span><span class="o">=</span>&lt;strong-password&gt;
</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nv">REDIS_PASSWORD</span><span class="o">=</span>&lt;strong-password&gt;
</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nv">JWT_ACCESS_SECRET</span><span class="o">=</span>&lt;openssl-rand-hex-32&gt;
</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="nv">JWT_REFRESH_SECRET</span><span class="o">=</span>&lt;openssl-rand-hex-32&gt;
</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="nv">ENCRYPTION_KEY</span><span class="o">=</span>&lt;openssl-rand-hex-32&gt;<span class="w"> </span><span class="c1"># Production only</span>
</span></code></pre></div></p>
<p><strong>All other variables</strong> have safe defaults for development.</p>
<hr />
<h2 id="general-configuration">General Configuration<a class="headerlink" href="#general-configuration" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>NODE_ENV</code></td>
<td><code>development</code></td>
<td>No</td>
<td>Environment mode (<code>development</code> | <code>production</code>)</td>
</tr>
<tr>
<td><code>DOMAIN</code></td>
<td><code>cmlite.org</code></td>
<td>No</td>
<td>Base domain for subdomain routing</td>
</tr>
<tr>
<td><code>USER_ID</code></td>
<td><code>1000</code></td>
<td>No</td>
<td>Host user ID for volume permissions</td>
</tr>
<tr>
<td><code>GROUP_ID</code></td>
<td><code>1000</code></td>
<td>No</td>
<td>Host group ID for volume permissions</td>
</tr>
<tr>
<td><code>DOCKER_GROUP_ID</code></td>
<td><code>984</code></td>
<td>No</td>
<td>Docker group ID (for homepage container)</td>
</tr>
</tbody>
</table>
<p><strong>Usage</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nv">NODE_ENV</span><span class="o">=</span>production<span class="w"> </span>docker<span class="w"> </span>compose<span class="w"> </span>up<span class="w"> </span>-d
</span></code></pre></div></p>
<hr />
<h2 id="v2-postgresql">V2 PostgreSQL<a class="headerlink" href="#v2-postgresql" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>V2_POSTGRES_USER</code></td>
<td><code>changemaker</code></td>
<td>No</td>
<td>PostgreSQL username</td>
</tr>
<tr>
<td><code>V2_POSTGRES_PASSWORD</code></td>
<td><code>CHANGE_ME_STRONG_PASSWORD</code></td>
<td><strong>Yes</strong></td>
<td>PostgreSQL password</td>
</tr>
<tr>
<td><code>V2_POSTGRES_DB</code></td>
<td><code>changemaker_v2</code></td>
<td>No</td>
<td>Database name</td>
</tr>
<tr>
<td><code>V2_POSTGRES_PORT</code></td>
<td><code>5433</code></td>
<td>No</td>
<td>Host port (container always 5432)</td>
</tr>
</tbody>
</table>
<p><strong>Connection String</strong> (auto-generated in docker-compose.yml):
<div class="language-text highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>postgresql://changemaker:PASSWORD@changemaker-v2-postgres:5432/changemaker_v2
</span></code></pre></div></p>
<p><strong>Port Binding</strong>: <code>127.0.0.1:5433:5432</code> (localhost only for security)</p>
<p><strong>Important</strong>: Change <code>V2_POSTGRES_PASSWORD</code> before production deployment.</p>
<hr />
<h2 id="jwt-authentication">JWT Authentication<a class="headerlink" href="#jwt-authentication" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>JWT_ACCESS_SECRET</code></td>
<td><code>GENERATE_WITH_openssl_rand_hex_32</code></td>
<td><strong>Yes</strong></td>
<td>Access token secret (15min lifespan)</td>
</tr>
<tr>
<td><code>JWT_REFRESH_SECRET</code></td>
<td><code>GENERATE_WITH_openssl_rand_hex_32</code></td>
<td><strong>Yes</strong></td>
<td>Refresh token secret (7 day lifespan)</td>
</tr>
<tr>
<td><code>JWT_ACCESS_EXPIRY</code></td>
<td><code>15m</code></td>
<td>No</td>
<td>Access token expiration (<code>15m</code>, <code>1h</code>, etc.)</td>
</tr>
<tr>
<td><code>JWT_REFRESH_EXPIRY</code></td>
<td><code>7d</code></td>
<td>No</td>
<td>Refresh token expiration (<code>7d</code>, <code>30d</code>, etc.)</td>
</tr>
<tr>
<td><code>ENCRYPTION_KEY</code></td>
<td><code>GENERATE_WITH_openssl_rand_hex_32</code></td>
<td><strong>Yes (prod)</strong></td>
<td>DB encryption key for SMTP passwords, etc.</td>
</tr>
</tbody>
</table>
<p><strong>Security Requirements</strong> (enforced by Zod schema):
- <code>JWT_ACCESS_SECRET</code> must be 32+ characters
- <code>JWT_REFRESH_SECRET</code> must be 32+ characters
- <code>ENCRYPTION_KEY</code> must be 32+ characters <strong>and differ from JWT secrets</strong></p>
<p><strong>Generation</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">JWT_ACCESS_SECRET</span><span class="o">=</span><span class="k">$(</span>openssl<span class="w"> </span>rand<span class="w"> </span>-hex<span class="w"> </span><span class="m">32</span><span class="k">)</span>
</span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">JWT_REFRESH_SECRET</span><span class="o">=</span><span class="k">$(</span>openssl<span class="w"> </span>rand<span class="w"> </span>-hex<span class="w"> </span><span class="m">32</span><span class="k">)</span>
</span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nb">export</span><span class="w"> </span><span class="nv">ENCRYPTION_KEY</span><span class="o">=</span><span class="k">$(</span>openssl<span class="w"> </span>rand<span class="w"> </span>-hex<span class="w"> </span><span class="m">32</span><span class="k">)</span>
</span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;JWT_ACCESS_SECRET=</span><span class="si">${</span><span class="nv">JWT_ACCESS_SECRET</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>.env
</span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;JWT_REFRESH_SECRET=</span><span class="si">${</span><span class="nv">JWT_REFRESH_SECRET</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>.env
</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;ENCRYPTION_KEY=</span><span class="si">${</span><span class="nv">ENCRYPTION_KEY</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>.env
</span></code></pre></div></p>
<p><strong>Production Note</strong>: <code>ENCRYPTION_KEY</code> required in production (dev mode allows empty for testing).</p>
<hr />
<h2 id="redis">Redis<a class="headerlink" href="#redis" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>REDIS_PASSWORD</code></td>
<td><code>CHANGE_ME_REDIS_PASSWORD</code></td>
<td><strong>Yes</strong></td>
<td>Redis authentication password</td>
</tr>
<tr>
<td><code>REDIS_URL</code></td>
<td><code>redis://:PASSWORD@redis-changemaker:6379</code></td>
<td>No</td>
<td>Full connection URL (auto-generated)</td>
</tr>
</tbody>
</table>
<p><strong>Format</strong>: <code>redis://[:&lt;password&gt;@]&lt;host&gt;:&lt;port&gt;[/&lt;db&gt;]</code></p>
<p><strong>Example</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nv">REDIS_PASSWORD</span><span class="o">=</span>mySecurePassword123
</span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="nv">REDIS_URL</span><span class="o">=</span>redis://:mySecurePassword123@redis-changemaker:6379
</span></code></pre></div></p>
<p><strong>Security Note</strong>: As of Security Audit 2025-02-11, Redis <strong>requires authentication</strong> in production.</p>
<p><strong>Docker Command</strong> (in docker-compose.yml):
<div class="language-yaml highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nt">command</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">redis-server --appendonly yes --maxmemory 512mb --maxmemory-policy allkeys-lru --requirepass &quot;${REDIS_PASSWORD}&quot;</span>
</span></code></pre></div></p>
<hr />
<h2 id="api-configuration">API Configuration<a class="headerlink" href="#api-configuration" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>API_PORT</code></td>
<td><code>4000</code></td>
<td>No</td>
<td>Express API port (host)</td>
</tr>
<tr>
<td><code>API_URL</code></td>
<td><code>http://localhost:4000</code></td>
<td>No</td>
<td>Public API URL (for emails, OAuth redirects)</td>
</tr>
<tr>
<td><code>CORS_ORIGINS</code></td>
<td><code>http://localhost:3000,http://localhost</code></td>
<td>No</td>
<td>Allowed CORS origins (comma-separated)</td>
</tr>
</tbody>
</table>
<p><strong>Production Example</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="nv">API_PORT</span><span class="o">=</span><span class="m">4000</span>
</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="nv">API_URL</span><span class="o">=</span>https://api.cmlite.org
</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="nv">CORS_ORIGINS</span><span class="o">=</span>https://app.cmlite.org,https://cmlite.org
</span></code></pre></div></p>
<p><strong>CORS Note</strong>: List all frontend origins (admin, public site, media gallery).</p>
<hr />
<h2 id="admin-gui">Admin GUI<a class="headerlink" href="#admin-gui" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>ADMIN_PORT</code></td>
<td><code>3000</code></td>
<td>No</td>
<td>Admin GUI port (host)</td>
</tr>
<tr>
<td><code>ADMIN_URL</code></td>
<td><code>http://localhost:3000</code></td>
<td>No</td>
<td>Public admin URL</td>
</tr>
<tr>
<td><code>VITE_API_URL</code></td>
<td><code>http://changemaker-v2-api:4000</code></td>
<td>No</td>
<td>API URL for Vite proxy (Docker internal)</td>
</tr>
<tr>
<td><code>VITE_MEDIA_API_URL</code></td>
<td><code>http://changemaker-media-api:4100</code></td>
<td>No</td>
<td>Media API URL for Vite proxy</td>
</tr>
<tr>
<td><code>VITE_MKDOCS_URL</code></td>
<td><code>http://mkdocs-changemaker:8000</code></td>
<td>No</td>
<td>MkDocs URL for iframe embed</td>
</tr>
</tbody>
</table>
<p><strong>Development vs Production</strong>:</p>
<p><strong>Development</strong> (Docker):
<div class="language-bash highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nv">VITE_API_URL</span><span class="o">=</span>http://changemaker-v2-api:4000<span class="w"> </span><span class="c1"># Container name</span>
</span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="nv">VITE_MEDIA_API_URL</span><span class="o">=</span>http://changemaker-media-api:4100
</span></code></pre></div></p>
<p><strong>Development</strong> (local):
<div class="language-bash highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="nv">VITE_API_URL</span><span class="o">=</span>http://localhost:4000<span class="w"> </span><span class="c1"># Localhost</span>
</span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="nv">VITE_MEDIA_API_URL</span><span class="o">=</span>http://localhost:4100
</span></code></pre></div></p>
<p><strong>Production</strong>: Vite build embeds these URLs at build time.</p>
<hr />
<h2 id="nginx">Nginx<a class="headerlink" href="#nginx" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>NGINX_HTTP_PORT</code></td>
<td><code>80</code></td>
<td>No</td>
<td>HTTP port</td>
</tr>
<tr>
<td><code>NGINX_HTTPS_PORT</code></td>
<td><code>443</code></td>
<td>No</td>
<td>HTTPS port</td>
</tr>
</tbody>
</table>
<p><strong>Port Mapping</strong> (docker-compose.yml):
<div class="language-yaml highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="nt">nginx</span><span class="p">:</span>
</span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="w"> </span><span class="nt">ports</span><span class="p">:</span>
</span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;80:80&quot;</span>
</span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;443:443&quot;</span>
</span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;8881:8881&quot;</span><span class="w"> </span><span class="c1"># NocoDB embed proxy</span>
</span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;8882:8882&quot;</span><span class="w"> </span><span class="c1"># n8n embed proxy</span>
</span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;8883:8883&quot;</span><span class="w"> </span><span class="c1"># Gitea embed proxy</span>
</span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;8884:8884&quot;</span><span class="w"> </span><span class="c1"># MailHog embed proxy</span>
</span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&quot;8885:8885&quot;</span><span class="w"> </span><span class="c1"># Mini QR embed proxy</span>
</span></code></pre></div></p>
<p><strong>Custom Ports</strong> (if 80/443 occupied):
<div class="language-bash highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="nv">NGINX_HTTP_PORT</span><span class="o">=</span><span class="m">8080</span>
</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="nv">NGINX_HTTPS_PORT</span><span class="o">=</span><span class="m">8443</span>
</span></code></pre></div></p>
<hr />
<h2 id="smtp-email">SMTP / Email<a class="headerlink" href="#smtp-email" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>SMTP_HOST</code></td>
<td><code>mailhog-changemaker</code></td>
<td>No</td>
<td>SMTP server hostname</td>
</tr>
<tr>
<td><code>SMTP_PORT</code></td>
<td><code>1025</code></td>
<td>No</td>
<td>SMTP server port</td>
</tr>
<tr>
<td><code>SMTP_USER</code></td>
<td>``</td>
<td>No</td>
<td>SMTP username (empty for MailHog)</td>
</tr>
<tr>
<td><code>SMTP_PASS</code></td>
<td>``</td>
<td>No</td>
<td>SMTP password</td>
</tr>
<tr>
<td><code>SMTP_FROM</code></td>
<td><code>noreply@cmlite.org</code></td>
<td>No</td>
<td>Default sender email</td>
</tr>
<tr>
<td><code>SMTP_FROM_NAME</code></td>
<td><code>Changemaker Lite</code></td>
<td>No</td>
<td>Default sender name</td>
</tr>
<tr>
<td><code>EMAIL_TEST_MODE</code></td>
<td><code>true</code></td>
<td>No</td>
<td>Route all emails to MailHog (dev mode)</td>
</tr>
<tr>
<td><code>TEST_EMAIL_RECIPIENT</code></td>
<td><code>admin@cmlite.org</code></td>
<td>No</td>
<td>Override recipient in test mode</td>
</tr>
</tbody>
</table>
<p><strong>Development</strong> (MailHog):
<div class="language-bash highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="nv">SMTP_HOST</span><span class="o">=</span>mailhog-changemaker
</span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="nv">SMTP_PORT</span><span class="o">=</span><span class="m">1025</span>
</span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="nv">SMTP_USER</span><span class="o">=</span>
</span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="nv">SMTP_PASS</span><span class="o">=</span>
</span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="nv">EMAIL_TEST_MODE</span><span class="o">=</span><span class="nb">true</span>
</span></code></pre></div></p>
<p><strong>Production</strong> (e.g., ProtonMail):
<div class="language-bash highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="nv">SMTP_HOST</span><span class="o">=</span>smtp.protonmail.ch
</span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="nv">SMTP_PORT</span><span class="o">=</span><span class="m">587</span>
</span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="nv">SMTP_USER</span><span class="o">=</span>your@email.com
</span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="nv">SMTP_PASS</span><span class="o">=</span>your-app-password
</span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="nv">EMAIL_TEST_MODE</span><span class="o">=</span><span class="nb">false</span>
</span></code></pre></div></p>
<p><strong>Test Mode Behavior</strong>:
- <code>true</code>: All emails sent to MailHog (visible at http://localhost:8025)
- <code>false</code>: Emails sent to real recipients via SMTP</p>
<p><strong>SiteSettings Override</strong>: Admins can override SMTP config via <code>/app/settings</code> (stored encrypted in DB).</p>
<hr />
<h2 id="listmonk">Listmonk<a class="headerlink" href="#listmonk" title="Permanent link">&para;</a></h2>
<h3 id="database">Database<a class="headerlink" href="#database" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>LISTMONK_DB_PORT</code></td>
<td><code>5432</code></td>
<td>No</td>
<td>Listmonk PostgreSQL port</td>
</tr>
<tr>
<td><code>LISTMONK_DB_USER</code></td>
<td><code>listmonk</code></td>
<td>No</td>
<td>Database username</td>
</tr>
<tr>
<td><code>LISTMONK_DB_PASSWORD</code></td>
<td><code>CHANGE_ME_LISTMONK_PASSWORD</code></td>
<td><strong>Yes</strong></td>
<td>Database password</td>
</tr>
<tr>
<td><code>LISTMONK_DB_NAME</code></td>
<td><code>listmonk</code></td>
<td>No</td>
<td>Database name</td>
</tr>
</tbody>
</table>
<h3 id="web-admin">Web Admin<a class="headerlink" href="#web-admin" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>LISTMONK_PORT</code></td>
<td><code>9001</code></td>
<td>No</td>
<td>Listmonk web UI port</td>
</tr>
<tr>
<td><code>LISTMONK_WEB_ADMIN_USER</code></td>
<td><code>admin</code></td>
<td>No</td>
<td>Web UI username</td>
</tr>
<tr>
<td><code>LISTMONK_WEB_ADMIN_PASSWORD</code></td>
<td><code>CHANGE_ME_LISTMONK_ADMIN</code></td>
<td><strong>Yes</strong></td>
<td>Web UI password</td>
</tr>
</tbody>
</table>
<h3 id="api-integration">API Integration<a class="headerlink" href="#api-integration" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>LISTMONK_API_USER</code></td>
<td><code>v2-api</code></td>
<td>No</td>
<td>API user (auto-created by listmonk-init)</td>
</tr>
<tr>
<td><code>LISTMONK_API_TOKEN</code></td>
<td><code>GENERATE_WITH_openssl_rand_hex_16</code></td>
<td><strong>Yes</strong></td>
<td>API token (plaintext, not bcrypt)</td>
</tr>
<tr>
<td><code>LISTMONK_ADMIN_USER</code></td>
<td><code>v2-api</code></td>
<td>No</td>
<td>Alias for API user (V2 uses this)</td>
</tr>
<tr>
<td><code>LISTMONK_ADMIN_PASSWORD</code></td>
<td><code>SAME_AS_LISTMONK_API_TOKEN</code></td>
<td><strong>Yes</strong></td>
<td>Alias for API token</td>
</tr>
<tr>
<td><code>LISTMONK_SYNC_ENABLED</code></td>
<td><code>false</code></td>
<td>No</td>
<td>Enable participant/location sync</td>
</tr>
<tr>
<td><code>LISTMONK_PROXY_PORT</code></td>
<td><code>9002</code></td>
<td>No</td>
<td>OAuth proxy port (for future integrations)</td>
</tr>
</tbody>
</table>
<p><strong>API User Setup</strong>: The <code>listmonk-init</code> container auto-creates the API user by directly inserting into PostgreSQL.</p>
<p><strong>Token Generation</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="nb">export</span><span class="w"> </span><span class="nv">LISTMONK_API_TOKEN</span><span class="o">=</span><span class="k">$(</span>openssl<span class="w"> </span>rand<span class="w"> </span>-hex<span class="w"> </span><span class="m">16</span><span class="k">)</span>
</span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;LISTMONK_API_TOKEN=</span><span class="si">${</span><span class="nv">LISTMONK_API_TOKEN</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>.env
</span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;LISTMONK_ADMIN_PASSWORD=</span><span class="si">${</span><span class="nv">LISTMONK_API_TOKEN</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>.env
</span></code></pre></div></p>
<p><strong>Sync Behavior</strong>:
- <code>false</code>: Manual sync only (default)
- <code>true</code>: Auto-sync participants/locations to Listmonk lists on signup/create</p>
<h3 id="smtp-configuration">SMTP Configuration<a class="headerlink" href="#smtp-configuration" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>LISTMONK_SMTP_HOST</code></td>
<td><code>mailhog-changemaker</code></td>
<td>No</td>
<td>SMTP server for newsletters</td>
</tr>
<tr>
<td><code>LISTMONK_SMTP_PORT</code></td>
<td><code>1025</code></td>
<td>No</td>
<td>SMTP port</td>
</tr>
<tr>
<td><code>LISTMONK_SMTP_USER</code></td>
<td>``</td>
<td>No</td>
<td>SMTP username</td>
</tr>
<tr>
<td><code>LISTMONK_SMTP_PASSWORD</code></td>
<td>``</td>
<td>No</td>
<td>SMTP password</td>
</tr>
<tr>
<td><code>LISTMONK_SMTP_TLS_TYPE</code></td>
<td><code>none</code></td>
<td>No</td>
<td>TLS mode (<code>none</code> | <code>STARTTLS</code> | <code>TLS</code>)</td>
</tr>
<tr>
<td><code>LISTMONK_SMTP_FROM</code></td>
<td><code>Changemaker Lite &lt;noreply@cmlite.org&gt;</code></td>
<td>No</td>
<td>Newsletter sender</td>
</tr>
</tbody>
</table>
<p><strong>listmonk-init Behavior</strong>: Configures <strong>dual SMTP providers</strong> (MailHog + production if credentials set).</p>
<hr />
<h2 id="represent-api">Represent API<a class="headerlink" href="#represent-api" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>REPRESENT_API_URL</code></td>
<td><code>https://represent.opennorth.ca</code></td>
<td>No</td>
<td>Represent API endpoint (Canadian electoral data)</td>
</tr>
</tbody>
</table>
<p><strong>Free Public API</strong>: No authentication required.</p>
<p><strong>Usage</strong>: Postal code → representative lookup for Influence campaigns.</p>
<hr />
<h2 id="nocodb">NocoDB<a class="headerlink" href="#nocodb" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>NOCODB_V2_PORT</code></td>
<td><code>8091</code></td>
<td>No</td>
<td>NocoDB web UI port</td>
</tr>
<tr>
<td><code>NOCODB_URL</code></td>
<td><code>http://changemaker-v2-nocodb:8080</code></td>
<td>No</td>
<td>Internal NocoDB URL</td>
</tr>
<tr>
<td><code>NC_ADMIN_EMAIL</code></td>
<td><code>admin@cmlite.org</code></td>
<td>No</td>
<td>Admin email</td>
</tr>
<tr>
<td><code>NC_ADMIN_PASSWORD</code></td>
<td><code>CHANGE_ME_NOCODB_PASSWORD</code></td>
<td><strong>Yes</strong></td>
<td>Admin password</td>
</tr>
<tr>
<td><code>NC_PUBLIC_URL</code></td>
<td><code>http://localhost:8091</code></td>
<td>No</td>
<td>Public NocoDB URL</td>
</tr>
</tbody>
</table>
<p><strong>Database Connection</strong>: Uses separate <code>nocodb_meta</code> database (auto-created by <code>init-nocodb-db.sh</code>).</p>
<p><strong>Connection String</strong>:
<div class="language-text highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>pg://changemaker-v2-postgres:5432?u=changemaker&amp;p=PASSWORD&amp;d=nocodb_meta
</span></code></pre></div></p>
<hr />
<h2 id="media-management">Media Management<a class="headerlink" href="#media-management" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>ENABLE_MEDIA_FEATURES</code></td>
<td><code>false</code></td>
<td>No</td>
<td>Enable media manager features</td>
</tr>
<tr>
<td><code>MEDIA_API_PORT</code></td>
<td><code>4100</code></td>
<td>No</td>
<td>Fastify media API port</td>
</tr>
<tr>
<td><code>MEDIA_API_PUBLIC_URL</code></td>
<td><code>http://media-api:4100</code></td>
<td>No</td>
<td>Public media API URL</td>
</tr>
<tr>
<td><code>MEDIA_ROOT</code></td>
<td><code>/media/library</code></td>
<td>No</td>
<td>Media library root path</td>
</tr>
<tr>
<td><code>MEDIA_UPLOADS</code></td>
<td><code>/media/uploads</code></td>
<td>No</td>
<td>Upload staging directory</td>
</tr>
<tr>
<td><code>MAX_UPLOAD_SIZE_GB</code></td>
<td><code>10</code></td>
<td>No</td>
<td>Max video upload size (GB)</td>
</tr>
<tr>
<td><code>PUBLIC_MEDIA_PORT</code></td>
<td><code>3100</code></td>
<td>No</td>
<td>Public media gallery port</td>
</tr>
<tr>
<td><code>VIDEO_PLAYER_DEBUG</code></td>
<td><code>false</code></td>
<td>No</td>
<td>Enable video.js debug logging</td>
</tr>
</tbody>
</table>
<p><strong>Feature Flag</strong>: Set <code>ENABLE_MEDIA_FEATURES=true</code> to activate media routes.</p>
<p><strong>Volume Mounts</strong> (in docker-compose.yml):
<div class="language-yaml highlight"><pre><span></span><code><span id="__span-16-1"><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="nt">volumes</span><span class="p">:</span>
</span><span id="__span-16-2"><a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">${MEDIA_ROOT:-./media}:/media:ro</span><span class="w"> </span><span class="c1"># Library (read-only)</span>
</span><span id="__span-16-3"><a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">${MEDIA_ROOT:-./media}/local/inbox:/media/local/inbox:rw</span><span class="w"> </span><span class="c1"># Inbox (writable)</span>
</span></code></pre></div></p>
<p><strong>Supported Formats</strong>: MP4, MOV, AVI, MKV, WebM, M4V, FLV</p>
<hr />
<h2 id="gitea">Gitea<a class="headerlink" href="#gitea" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>GITEA_URL</code></td>
<td><code>http://gitea-changemaker:3000</code></td>
<td>No</td>
<td>Internal Gitea URL</td>
</tr>
<tr>
<td><code>GITEA_WEB_PORT</code></td>
<td><code>3030</code></td>
<td>No</td>
<td>Gitea web UI port</td>
</tr>
<tr>
<td><code>GITEA_SSH_PORT</code></td>
<td><code>2222</code></td>
<td>No</td>
<td>Gitea SSH port (for git push/pull)</td>
</tr>
<tr>
<td><code>GITEA_DB_TYPE</code></td>
<td><code>mysql</code></td>
<td>No</td>
<td>Database type</td>
</tr>
<tr>
<td><code>GITEA_DB_HOST</code></td>
<td><code>gitea-db:3306</code></td>
<td>No</td>
<td>MySQL hostname</td>
</tr>
<tr>
<td><code>GITEA_DB_NAME</code></td>
<td><code>gitea</code></td>
<td>No</td>
<td>Database name</td>
</tr>
<tr>
<td><code>GITEA_DB_USER</code></td>
<td><code>gitea</code></td>
<td>No</td>
<td>Database username</td>
</tr>
<tr>
<td><code>GITEA_DB_PASSWD</code></td>
<td><code>CHANGE_ME_GITEA_DB</code></td>
<td><strong>Yes</strong></td>
<td>Database password</td>
</tr>
<tr>
<td><code>GITEA_DB_ROOT_PASSWORD</code></td>
<td><code>CHANGE_ME_GITEA_ROOT</code></td>
<td><strong>Yes</strong></td>
<td>MySQL root password</td>
</tr>
<tr>
<td><code>GITEA_ROOT_URL</code></td>
<td><code>https://git.cmlite.org</code></td>
<td>No</td>
<td>Public Gitea URL</td>
</tr>
<tr>
<td><code>GITEA_DOMAIN</code></td>
<td><code>git.cmlite.org</code></td>
<td>No</td>
<td>Gitea domain</td>
</tr>
</tbody>
</table>
<p><strong>First-Time Setup</strong>: Visit http://localhost:3030 to create admin account.</p>
<p><strong>Git Commands</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="c1"># Clone via HTTP</span>
</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a>git<span class="w"> </span>clone<span class="w"> </span>http://localhost:3030/user/repo.git
</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a>
</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="c1"># Clone via SSH</span>
</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a>git<span class="w"> </span>clone<span class="w"> </span>ssh://git@localhost:2222/user/repo.git
</span></code></pre></div></p>
<hr />
<h2 id="n8n">n8n<a class="headerlink" href="#n8n" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>N8N_URL</code></td>
<td><code>http://n8n-changemaker:5678</code></td>
<td>No</td>
<td>Internal n8n URL</td>
</tr>
<tr>
<td><code>N8N_PORT</code></td>
<td><code>5678</code></td>
<td>No</td>
<td>n8n port</td>
</tr>
<tr>
<td><code>N8N_HOST</code></td>
<td><code>n8n.cmlite.org</code></td>
<td>No</td>
<td>Public n8n hostname</td>
</tr>
<tr>
<td><code>N8N_ENCRYPTION_KEY</code></td>
<td><code>CHANGE_ME_N8N_KEY</code></td>
<td><strong>Yes</strong></td>
<td>Workflow encryption key</td>
</tr>
<tr>
<td><code>N8N_USER_EMAIL</code></td>
<td><code>admin@example.com</code></td>
<td>No</td>
<td>Default admin email</td>
</tr>
<tr>
<td><code>N8N_USER_PASSWORD</code></td>
<td><code>CHANGE_ME_N8N_PASSWORD</code></td>
<td><strong>Yes</strong></td>
<td>Default admin password</td>
</tr>
<tr>
<td><code>GENERIC_TIMEZONE</code></td>
<td><code>UTC</code></td>
<td>No</td>
<td>Workflow timezone</td>
</tr>
</tbody>
</table>
<p><strong>First Start</strong>: n8n creates admin user with <code>N8N_USER_EMAIL</code>/<code>N8N_USER_PASSWORD</code> automatically.</p>
<p><strong>Encryption Key</strong>: Used to encrypt credentials in workflows.</p>
<hr />
<h2 id="mkdocs">MkDocs<a class="headerlink" href="#mkdocs" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>MKDOCS_PORT</code></td>
<td><code>4003</code></td>
<td>No</td>
<td>MkDocs live preview port</td>
</tr>
<tr>
<td><code>MKDOCS_SITE_SERVER_PORT</code></td>
<td><code>4001</code></td>
<td>No</td>
<td>MkDocs static site port</td>
</tr>
<tr>
<td><code>BASE_DOMAIN</code></td>
<td><code>https://cmlite.org</code></td>
<td>No</td>
<td>Site URL for sitemap/canonical</td>
</tr>
<tr>
<td><code>MKDOCS_PREVIEW_URL</code></td>
<td><code>http://mkdocs:8000</code></td>
<td>No</td>
<td>Internal preview URL</td>
</tr>
<tr>
<td><code>MKDOCS_DOCS_PATH</code></td>
<td><code>/mkdocs/docs</code></td>
<td>No</td>
<td>Documentation source path</td>
</tr>
</tbody>
</table>
<p><strong>Port Change</strong>: Was 4000 in V1, changed to 4003 to avoid conflict with API.</p>
<p><strong>Live Reload</strong>: http://localhost:4003 (updates on file save)</p>
<p><strong>Static Build</strong>: http://localhost:4001 (Nginx-served production build)</p>
<hr />
<h2 id="code-server">Code Server<a class="headerlink" href="#code-server" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>CODE_SERVER_PORT</code></td>
<td><code>8888</code></td>
<td>No</td>
<td>Code Server port</td>
</tr>
<tr>
<td><code>CODE_SERVER_URL</code></td>
<td><code>http://code-server:8080</code></td>
<td>No</td>
<td>Internal Code Server URL</td>
</tr>
<tr>
<td><code>USER_NAME</code></td>
<td><code>coder</code></td>
<td>No</td>
<td>Code Server username</td>
</tr>
</tbody>
</table>
<p><strong>Access</strong>: http://localhost:8888</p>
<p><strong>Password</strong>: Set in <code>configs/code-server/.config/code-server/config.yaml</code></p>
<hr />
<h2 id="homepage">Homepage<a class="headerlink" href="#homepage" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>HOMEPAGE_PORT</code></td>
<td><code>3010</code></td>
<td>No</td>
<td>Homepage dashboard port</td>
</tr>
<tr>
<td><code>HOMEPAGE_VAR_BASE_URL</code></td>
<td><code>http://localhost</code></td>
<td>No</td>
<td>Base URL for service links</td>
</tr>
</tbody>
</table>
<p><strong>Configuration</strong>: Edit <code>configs/homepage/services.yaml</code> to customize dashboard.</p>
<hr />
<h2 id="mini-qr">Mini QR<a class="headerlink" href="#mini-qr" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>MINI_QR_PORT</code></td>
<td><code>8089</code></td>
<td>No</td>
<td>Mini QR service port</td>
</tr>
<tr>
<td><code>MINI_QR_URL</code></td>
<td><code>http://mini-qr:8080</code></td>
<td>No</td>
<td>Internal Mini QR URL</td>
</tr>
<tr>
<td><code>MINI_QR_EMBED_PORT</code></td>
<td><code>8885</code></td>
<td>No</td>
<td>Nginx embed proxy port</td>
</tr>
</tbody>
</table>
<p><strong>Usage</strong>: Walk sheets + cut exports embed QR codes via API or iframe.</p>
<hr />
<h2 id="mailhog">MailHog<a class="headerlink" href="#mailhog" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>MAILHOG_SMTP_PORT</code></td>
<td><code>1025</code></td>
<td>No</td>
<td>SMTP port (internal only)</td>
</tr>
<tr>
<td><code>MAILHOG_WEB_PORT</code></td>
<td><code>8025</code></td>
<td>No</td>
<td>Web UI port</td>
</tr>
</tbody>
</table>
<p><strong>Web UI</strong>: http://localhost:8025</p>
<p><strong>SMTP</strong>: Only accessible from Docker network (not exposed to host).</p>
<hr />
<h2 id="nar-import">NAR Import<a class="headerlink" href="#nar-import" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>NAR_DATA_DIR</code></td>
<td><code>/data</code></td>
<td>No</td>
<td>Path to NAR data directory (in container)</td>
</tr>
</tbody>
</table>
<p><strong>Host Mount</strong> (in docker-compose.yml):
<div class="language-yaml highlight"><pre><span></span><code><span id="__span-18-1"><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a><span class="nt">volumes</span><span class="p">:</span>
</span><span id="__span-18-2"><a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">./data:/data:ro</span><span class="w"> </span><span class="c1"># Read-only NAR data</span>
</span></code></pre></div></p>
<p><strong>Data Structure</strong>:
<div class="language-text highlight"><pre><span></span><code><span id="__span-19-1"><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>./data/
</span><span id="__span-19-2"><a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a>└─ 202501/ (YYYYMM)
</span><span id="__span-19-3"><a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a> ├─ Addresses/
</span><span id="__span-19-4"><a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a> │ ├─ Address_10.txt (PEI)
</span><span id="__span-19-5"><a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a> │ ├─ Address_24_part_1.txt (Quebec part 1)
</span><span id="__span-19-6"><a id="__codelineno-19-6" name="__codelineno-19-6" href="#__codelineno-19-6"></a> │ └─ ...
</span><span id="__span-19-7"><a id="__codelineno-19-7" name="__codelineno-19-7" href="#__codelineno-19-7"></a> └─ Locations/
</span><span id="__span-19-8"><a id="__codelineno-19-8" name="__codelineno-19-8" href="#__codelineno-19-8"></a> ├─ Location_10.txt
</span><span id="__span-19-9"><a id="__codelineno-19-9" name="__codelineno-19-9" href="#__codelineno-19-9"></a> └─ ...
</span></code></pre></div></p>
<p><strong>Download</strong>: https://www150.statcan.gc.ca/n1/pub/46-26-0002/462600022022001-eng.htm</p>
<hr />
<h2 id="geocoding">Geocoding<a class="headerlink" href="#geocoding" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>MAPBOX_API_KEY</code></td>
<td>``</td>
<td>No</td>
<td>Mapbox API key (optional, 100k free/month)</td>
</tr>
<tr>
<td><code>GEOCODING_RATE_LIMIT_MS</code></td>
<td><code>1100</code></td>
<td>No</td>
<td>Delay between provider requests (ms)</td>
</tr>
<tr>
<td><code>GEOCODING_CACHE_ENABLED</code></td>
<td><code>true</code></td>
<td>No</td>
<td>Enable Redis caching</td>
</tr>
<tr>
<td><code>GEOCODING_CACHE_TTL_HOURS</code></td>
<td><code>24</code></td>
<td>No</td>
<td>Cache TTL in hours</td>
</tr>
<tr>
<td><code>GOOGLE_MAPS_API_KEY</code></td>
<td>``</td>
<td>No</td>
<td>Google Maps API key (optional, paid)</td>
</tr>
<tr>
<td><code>GOOGLE_MAPS_ENABLED</code></td>
<td><code>false</code></td>
<td>No</td>
<td>Enable Google geocoding provider</td>
</tr>
<tr>
<td><code>GEOCODING_PARALLEL_ENABLED</code></td>
<td><code>true</code></td>
<td>No</td>
<td>Parallel geocoding for bulk imports</td>
</tr>
<tr>
<td><code>GEOCODING_BATCH_SIZE</code></td>
<td><code>10</code></td>
<td>No</td>
<td>Batch size for parallel geocoding</td>
</tr>
<tr>
<td><code>BULK_GEOCODE_ENABLED</code></td>
<td><code>true</code></td>
<td>No</td>
<td>Enable bulk re-geocode feature</td>
</tr>
<tr>
<td><code>BULK_GEOCODE_MAX_BATCH</code></td>
<td><code>5000</code></td>
<td>No</td>
<td>Max locations per bulk geocode batch</td>
</tr>
</tbody>
</table>
<p><strong>Providers</strong> (in fallback order):
1. <strong>Nominatim</strong> (OpenStreetMap, free)
2. <strong>ArcGIS</strong> (free tier)
3. <strong>Photon</strong> (free)
4. <strong>Mapbox</strong> (100k free/month, requires API key)
5. <strong>LocationIQ</strong> (free tier)
6. <strong>Google</strong> (paid, most accurate)</p>
<p><strong>Recommendation</strong>: Add <code>MAPBOX_API_KEY</code> for better accuracy without cost.</p>
<hr />
<h2 id="pangolin-tunnel">Pangolin Tunnel<a class="headerlink" href="#pangolin-tunnel" title="Permanent link">&para;</a></h2>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>PANGOLIN_API_URL</code></td>
<td><code>https://api.bnkserve.org/v1</code></td>
<td>No</td>
<td>Pangolin API endpoint</td>
</tr>
<tr>
<td><code>PANGOLIN_API_KEY</code></td>
<td>``</td>
<td>No</td>
<td>Pangolin API key</td>
</tr>
<tr>
<td><code>PANGOLIN_ORG_ID</code></td>
<td>``</td>
<td>No</td>
<td>Organization ID (from setup wizard)</td>
</tr>
<tr>
<td><code>PANGOLIN_SITE_ID</code></td>
<td>``</td>
<td>No</td>
<td>Site ID (from setup wizard)</td>
</tr>
<tr>
<td><code>PANGOLIN_ENDPOINT</code></td>
<td><code>https://pangolin.bnkserve.org</code></td>
<td>No</td>
<td>Tunnel endpoint URL</td>
</tr>
<tr>
<td><code>PANGOLIN_NEWT_ID</code></td>
<td>``</td>
<td>No</td>
<td>Newt connector ID</td>
</tr>
<tr>
<td><code>PANGOLIN_NEWT_SECRET</code></td>
<td>``</td>
<td>No</td>
<td>Newt connector secret</td>
</tr>
</tbody>
</table>
<p><strong>Setup Workflow</strong>:
1. Visit <code>/app/pangolin</code> in admin GUI
2. Enter <code>PANGOLIN_API_KEY</code>
3. Create org → site → endpoint → resource
4. Copy <code>NEWT_ID</code>/<code>NEWT_SECRET</code> to <code>.env</code>
5. Restart Newt container</p>
<p><strong>Manual Setup</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-20-1"><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a><span class="c1"># Set API key</span>
</span><span id="__span-20-2"><a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">PANGOLIN_API_KEY</span><span class="o">=</span>your-api-key
</span><span id="__span-20-3"><a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a>
</span><span id="__span-20-4"><a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a><span class="c1"># Create org (returns ORG_ID)</span>
</span><span id="__span-20-5"><a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$PANGOLIN_API_KEY</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
</span><span id="__span-20-6"><a id="__codelineno-20-6" name="__codelineno-20-6" href="#__codelineno-20-6"></a><span class="w"> </span>https://api.bnkserve.org/v1/orgs<span class="w"> </span><span class="se">\</span>
</span><span id="__span-20-7"><a id="__codelineno-20-7" name="__codelineno-20-7" href="#__codelineno-20-7"></a><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;{&quot;name&quot;:&quot;My Organization&quot;}&#39;</span>
</span><span id="__span-20-8"><a id="__codelineno-20-8" name="__codelineno-20-8" href="#__codelineno-20-8"></a>
</span><span id="__span-20-9"><a id="__codelineno-20-9" name="__codelineno-20-9" href="#__codelineno-20-9"></a><span class="c1"># Create site (returns SITE_ID)</span>
</span><span id="__span-20-10"><a id="__codelineno-20-10" name="__codelineno-20-10" href="#__codelineno-20-10"></a>curl<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Authorization: Bearer </span><span class="nv">$PANGOLIN_API_KEY</span><span class="s2">&quot;</span><span class="w"> </span><span class="se">\</span>
</span><span id="__span-20-11"><a id="__codelineno-20-11" name="__codelineno-20-11" href="#__codelineno-20-11"></a><span class="w"> </span>https://api.bnkserve.org/v1/sites<span class="w"> </span><span class="se">\</span>
</span><span id="__span-20-12"><a id="__codelineno-20-12" name="__codelineno-20-12" href="#__codelineno-20-12"></a><span class="w"> </span>-d<span class="w"> </span><span class="s1">&#39;{&quot;org_id&quot;:&quot;ORG_ID&quot;,&quot;name&quot;:&quot;Production Site&quot;}&#39;</span>
</span><span id="__span-20-13"><a id="__codelineno-20-13" name="__codelineno-20-13" href="#__codelineno-20-13"></a>
</span><span id="__span-20-14"><a id="__codelineno-20-14" name="__codelineno-20-14" href="#__codelineno-20-14"></a><span class="c1"># Continue setup...</span>
</span></code></pre></div></p>
<p>See <a href="../tunneling/">Tunneling</a> for complete guide.</p>
<hr />
<h2 id="monitoring">Monitoring<a class="headerlink" href="#monitoring" title="Permanent link">&para;</a></h2>
<h3 id="prometheus">Prometheus<a class="headerlink" href="#prometheus" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>PROMETHEUS_PORT</code></td>
<td><code>9090</code></td>
<td>No</td>
<td>Prometheus port</td>
</tr>
</tbody>
</table>
<p><strong>Scrape Targets</strong> (configured in <code>configs/prometheus/prometheus.yml</code>):
- <code>changemaker-v2-api:4000/api/metrics</code> (10s interval)
- <code>redis-exporter:9121</code> (15s interval)
- <code>cadvisor:8080</code> (15s interval)
- <code>node-exporter:9100</code> (15s interval)</p>
<p><strong>Retention</strong>: 30 days (configured in docker-compose.yml command).</p>
<h3 id="grafana">Grafana<a class="headerlink" href="#grafana" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>GRAFANA_PORT</code></td>
<td><code>3001</code></td>
<td>No</td>
<td>Grafana port</td>
</tr>
<tr>
<td><code>GRAFANA_ADMIN_PASSWORD</code></td>
<td><code>admin</code></td>
<td>No</td>
<td>Admin password</td>
</tr>
<tr>
<td><code>GRAFANA_ROOT_URL</code></td>
<td><code>http://localhost:3001</code></td>
<td>No</td>
<td>Public Grafana URL</td>
</tr>
</tbody>
</table>
<p><strong>Default Login</strong>: admin / admin (change on first login)</p>
<p><strong>Dashboards</strong>: 3 pre-configured dashboards auto-provisioned from <code>configs/grafana/</code></p>
<h3 id="exporters">Exporters<a class="headerlink" href="#exporters" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>CADVISOR_PORT</code></td>
<td><code>8080</code></td>
<td>No</td>
<td>cAdvisor container metrics port</td>
</tr>
<tr>
<td><code>NODE_EXPORTER_PORT</code></td>
<td><code>9100</code></td>
<td>No</td>
<td>Node exporter system metrics port</td>
</tr>
<tr>
<td><code>REDIS_EXPORTER_PORT</code></td>
<td><code>9121</code></td>
<td>No</td>
<td>Redis exporter port</td>
</tr>
</tbody>
</table>
<h3 id="alertmanager">Alertmanager<a class="headerlink" href="#alertmanager" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>ALERTMANAGER_PORT</code></td>
<td><code>9093</code></td>
<td>No</td>
<td>Alertmanager port</td>
</tr>
</tbody>
</table>
<p><strong>Configuration</strong>: Edit <code>configs/alertmanager/alertmanager.yml</code> for notification receivers.</p>
<h3 id="gotify">Gotify<a class="headerlink" href="#gotify" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>GOTIFY_PORT</code></td>
<td><code>8889</code></td>
<td>No</td>
<td>Gotify push notification server port</td>
</tr>
<tr>
<td><code>GOTIFY_ADMIN_USER</code></td>
<td><code>admin</code></td>
<td>No</td>
<td>Gotify admin username</td>
</tr>
<tr>
<td><code>GOTIFY_ADMIN_PASSWORD</code></td>
<td><code>admin</code></td>
<td>No</td>
<td>Gotify admin password</td>
</tr>
</tbody>
</table>
<p><strong>Usage</strong>: Create apps in Gotify UI, add webhook URL to Alertmanager.</p>
<hr />
<h2 id="security-checklist">Security Checklist<a class="headerlink" href="#security-checklist" title="Permanent link">&para;</a></h2>
<p><strong>Before production deployment</strong>:</p>
<ul class="task-list">
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Change all <code>CHANGE_ME_*</code> passwords</li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Generate strong <code>JWT_ACCESS_SECRET</code> (32+ chars)</li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Generate strong <code>JWT_REFRESH_SECRET</code> (32+ chars)</li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Generate strong <code>ENCRYPTION_KEY</code> (32+ chars, <strong>different from JWT secrets</strong>)</li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Set strong <code>REDIS_PASSWORD</code></li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Set strong <code>V2_POSTGRES_PASSWORD</code></li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Set strong <code>LISTMONK_DB_PASSWORD</code></li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Set strong <code>LISTMONK_API_TOKEN</code></li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Set strong <code>GITEA_DB_PASSWD</code> + <code>GITEA_DB_ROOT_PASSWORD</code></li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Set strong <code>N8N_ENCRYPTION_KEY</code> + <code>N8N_USER_PASSWORD</code></li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Set strong <code>NC_ADMIN_PASSWORD</code> (NocoDB)</li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Set strong <code>GRAFANA_ADMIN_PASSWORD</code></li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Disable <code>EMAIL_TEST_MODE</code> (set to <code>false</code>)</li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Configure real SMTP credentials</li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Set <code>NODE_ENV=production</code></li>
<li class="task-list-item"><label class="task-list-control"><input type="checkbox" disabled/><span class="task-list-indicator"></span></label> Review <code>CORS_ORIGINS</code> (whitelist only trusted domains)</li>
</ul>
<p><strong>Validation</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-21-1"><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a><span class="c1"># Check for remaining placeholders</span>
</span><span id="__span-21-2"><a id="__codelineno-21-2" name="__codelineno-21-2" href="#__codelineno-21-2"></a>grep<span class="w"> </span>-r<span class="w"> </span><span class="s2">&quot;CHANGE_ME&quot;</span><span class="w"> </span>.env
</span><span id="__span-21-3"><a id="__codelineno-21-3" name="__codelineno-21-3" href="#__codelineno-21-3"></a>
</span><span id="__span-21-4"><a id="__codelineno-21-4" name="__codelineno-21-4" href="#__codelineno-21-4"></a><span class="c1"># Verify secrets are different</span>
</span><span id="__span-21-5"><a id="__codelineno-21-5" name="__codelineno-21-5" href="#__codelineno-21-5"></a><span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;JWT_ACCESS_SECRET: </span><span class="k">$(</span>grep<span class="w"> </span>JWT_ACCESS_SECRET<span class="w"> </span>.env<span class="k">)</span><span class="s2">&quot;</span>
</span><span id="__span-21-6"><a id="__codelineno-21-6" name="__codelineno-21-6" href="#__codelineno-21-6"></a><span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;JWT_REFRESH_SECRET: </span><span class="k">$(</span>grep<span class="w"> </span>JWT_REFRESH_SECRET<span class="w"> </span>.env<span class="k">)</span><span class="s2">&quot;</span>
</span><span id="__span-21-7"><a id="__codelineno-21-7" name="__codelineno-21-7" href="#__codelineno-21-7"></a><span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;ENCRYPTION_KEY: </span><span class="k">$(</span>grep<span class="w"> </span>ENCRYPTION_KEY<span class="w"> </span>.env<span class="k">)</span><span class="s2">&quot;</span>
</span></code></pre></div></p>
<hr />
<h2 id="troubleshooting">Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permanent link">&para;</a></h2>
<h3 id="missing-env-file">Missing .env File<a class="headerlink" href="#missing-env-file" title="Permanent link">&para;</a></h3>
<p><strong>Symptoms</strong>: Containers fail to start with "missing environment variable" errors</p>
<p><strong>Solution</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-22-1"><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a><span class="c1"># Create from template</span>
</span><span id="__span-22-2"><a id="__codelineno-22-2" name="__codelineno-22-2" href="#__codelineno-22-2"></a>cp<span class="w"> </span>.env.example<span class="w"> </span>.env
</span><span id="__span-22-3"><a id="__codelineno-22-3" name="__codelineno-22-3" href="#__codelineno-22-3"></a>
</span><span id="__span-22-4"><a id="__codelineno-22-4" name="__codelineno-22-4" href="#__codelineno-22-4"></a><span class="c1"># Verify file exists</span>
</span><span id="__span-22-5"><a id="__codelineno-22-5" name="__codelineno-22-5" href="#__codelineno-22-5"></a>ls<span class="w"> </span>-la<span class="w"> </span>.env
</span></code></pre></div></p>
<hr />
<h3 id="invalid-environment-variables">Invalid Environment Variables<a class="headerlink" href="#invalid-environment-variables" title="Permanent link">&para;</a></h3>
<p><strong>Symptoms</strong>: API fails to start with Zod validation errors</p>
<p><strong>Diagnosis</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-23-1"><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a><span class="c1"># View API startup logs</span>
</span><span id="__span-23-2"><a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a>docker<span class="w"> </span>compose<span class="w"> </span>logs<span class="w"> </span>api<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-A10<span class="w"> </span><span class="s2">&quot;Environment validation&quot;</span>
</span></code></pre></div></p>
<p><strong>Common errors</strong>:
- <code>JWT_ACCESS_SECRET</code> too short (must be 32+ chars)
- <code>ENCRYPTION_KEY</code> same as <code>JWT_ACCESS_SECRET</code> (must differ)
- Invalid URL format (<code>API_URL</code> must start with http:// or https://)</p>
<p><strong>Solution</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-24-1"><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a><span class="c1"># Regenerate secrets</span>
</span><span id="__span-24-2"><a id="__codelineno-24-2" name="__codelineno-24-2" href="#__codelineno-24-2"></a><span class="nb">export</span><span class="w"> </span><span class="nv">JWT_ACCESS_SECRET</span><span class="o">=</span><span class="k">$(</span>openssl<span class="w"> </span>rand<span class="w"> </span>-hex<span class="w"> </span><span class="m">32</span><span class="k">)</span>
</span><span id="__span-24-3"><a id="__codelineno-24-3" name="__codelineno-24-3" href="#__codelineno-24-3"></a><span class="nb">export</span><span class="w"> </span><span class="nv">ENCRYPTION_KEY</span><span class="o">=</span><span class="k">$(</span>openssl<span class="w"> </span>rand<span class="w"> </span>-hex<span class="w"> </span><span class="m">32</span><span class="k">)</span>
</span><span id="__span-24-4"><a id="__codelineno-24-4" name="__codelineno-24-4" href="#__codelineno-24-4"></a>
</span><span id="__span-24-5"><a id="__codelineno-24-5" name="__codelineno-24-5" href="#__codelineno-24-5"></a><span class="c1"># Update .env</span>
</span><span id="__span-24-6"><a id="__codelineno-24-6" name="__codelineno-24-6" href="#__codelineno-24-6"></a>sed<span class="w"> </span>-i<span class="w"> </span><span class="s2">&quot;s/^JWT_ACCESS_SECRET=.*/JWT_ACCESS_SECRET=</span><span class="si">${</span><span class="nv">JWT_ACCESS_SECRET</span><span class="si">}</span><span class="s2">/&quot;</span><span class="w"> </span>.env
</span><span id="__span-24-7"><a id="__codelineno-24-7" name="__codelineno-24-7" href="#__codelineno-24-7"></a>sed<span class="w"> </span>-i<span class="w"> </span><span class="s2">&quot;s/^ENCRYPTION_KEY=.*/ENCRYPTION_KEY=</span><span class="si">${</span><span class="nv">ENCRYPTION_KEY</span><span class="si">}</span><span class="s2">/&quot;</span><span class="w"> </span>.env
</span><span id="__span-24-8"><a id="__codelineno-24-8" name="__codelineno-24-8" href="#__codelineno-24-8"></a>
</span><span id="__span-24-9"><a id="__codelineno-24-9" name="__codelineno-24-9" href="#__codelineno-24-9"></a><span class="c1"># Restart API</span>
</span><span id="__span-24-10"><a id="__codelineno-24-10" name="__codelineno-24-10" href="#__codelineno-24-10"></a>docker<span class="w"> </span>compose<span class="w"> </span>restart<span class="w"> </span>api
</span></code></pre></div></p>
<hr />
<h3 id="postgresql-connection-failures">PostgreSQL Connection Failures<a class="headerlink" href="#postgresql-connection-failures" title="Permanent link">&para;</a></h3>
<p><strong>Symptoms</strong>: API logs show <code>ECONNREFUSED</code> or <code>authentication failed</code></p>
<p><strong>Diagnosis</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-25-1"><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a><span class="c1"># Check PostgreSQL is running</span>
</span><span id="__span-25-2"><a id="__codelineno-25-2" name="__codelineno-25-2" href="#__codelineno-25-2"></a>docker<span class="w"> </span>compose<span class="w"> </span>ps<span class="w"> </span>v2-postgres
</span><span id="__span-25-3"><a id="__codelineno-25-3" name="__codelineno-25-3" href="#__codelineno-25-3"></a>
</span><span id="__span-25-4"><a id="__codelineno-25-4" name="__codelineno-25-4" href="#__codelineno-25-4"></a><span class="c1"># Test connection</span>
</span><span id="__span-25-5"><a id="__codelineno-25-5" name="__codelineno-25-5" href="#__codelineno-25-5"></a>docker<span class="w"> </span>compose<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>api<span class="w"> </span>npx<span class="w"> </span>prisma<span class="w"> </span>db<span class="w"> </span>pull
</span><span id="__span-25-6"><a id="__codelineno-25-6" name="__codelineno-25-6" href="#__codelineno-25-6"></a>
</span><span id="__span-25-7"><a id="__codelineno-25-7" name="__codelineno-25-7" href="#__codelineno-25-7"></a><span class="c1"># Verify DATABASE_URL</span>
</span><span id="__span-25-8"><a id="__codelineno-25-8" name="__codelineno-25-8" href="#__codelineno-25-8"></a>docker<span class="w"> </span>compose<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>api<span class="w"> </span>printenv<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>DATABASE_URL
</span></code></pre></div></p>
<p><strong>Solution</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-26-1"><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a><span class="c1"># Verify password matches in .env</span>
</span><span id="__span-26-2"><a id="__codelineno-26-2" name="__codelineno-26-2" href="#__codelineno-26-2"></a>grep<span class="w"> </span>V2_POSTGRES_PASSWORD<span class="w"> </span>.env
</span><span id="__span-26-3"><a id="__codelineno-26-3" name="__codelineno-26-3" href="#__codelineno-26-3"></a>
</span><span id="__span-26-4"><a id="__codelineno-26-4" name="__codelineno-26-4" href="#__codelineno-26-4"></a><span class="c1"># Restart PostgreSQL</span>
</span><span id="__span-26-5"><a id="__codelineno-26-5" name="__codelineno-26-5" href="#__codelineno-26-5"></a>docker<span class="w"> </span>compose<span class="w"> </span>restart<span class="w"> </span>v2-postgres
</span><span id="__span-26-6"><a id="__codelineno-26-6" name="__codelineno-26-6" href="#__codelineno-26-6"></a>
</span><span id="__span-26-7"><a id="__codelineno-26-7" name="__codelineno-26-7" href="#__codelineno-26-7"></a><span class="c1"># Wait for healthcheck</span>
</span><span id="__span-26-8"><a id="__codelineno-26-8" name="__codelineno-26-8" href="#__codelineno-26-8"></a>docker<span class="w"> </span>compose<span class="w"> </span>ps<span class="w"> </span>v2-postgres<span class="w"> </span><span class="c1"># Should show (healthy)</span>
</span></code></pre></div></p>
<hr />
<h3 id="redis-connection-failures">Redis Connection Failures<a class="headerlink" href="#redis-connection-failures" title="Permanent link">&para;</a></h3>
<p><strong>Symptoms</strong>: API logs show <code>ECONNREFUSED</code> or <code>WRONGPASS invalid password</code></p>
<p><strong>Diagnosis</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-27-1"><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a><span class="c1"># Check Redis is running</span>
</span><span id="__span-27-2"><a id="__codelineno-27-2" name="__codelineno-27-2" href="#__codelineno-27-2"></a>docker<span class="w"> </span>compose<span class="w"> </span>ps<span class="w"> </span>redis
</span><span id="__span-27-3"><a id="__codelineno-27-3" name="__codelineno-27-3" href="#__codelineno-27-3"></a>
</span><span id="__span-27-4"><a id="__codelineno-27-4" name="__codelineno-27-4" href="#__codelineno-27-4"></a><span class="c1"># Test connection</span>
</span><span id="__span-27-5"><a id="__codelineno-27-5" name="__codelineno-27-5" href="#__codelineno-27-5"></a>docker<span class="w"> </span>compose<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>redis<span class="w"> </span>redis-cli<span class="w"> </span>-a<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">REDIS_PASSWORD</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span>ping
</span></code></pre></div></p>
<p><strong>Solution</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-28-1"><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a><span class="c1"># Verify password in .env</span>
</span><span id="__span-28-2"><a id="__codelineno-28-2" name="__codelineno-28-2" href="#__codelineno-28-2"></a>grep<span class="w"> </span>REDIS_PASSWORD<span class="w"> </span>.env
</span><span id="__span-28-3"><a id="__codelineno-28-3" name="__codelineno-28-3" href="#__codelineno-28-3"></a>
</span><span id="__span-28-4"><a id="__codelineno-28-4" name="__codelineno-28-4" href="#__codelineno-28-4"></a><span class="c1"># Ensure REDIS_URL includes password</span>
</span><span id="__span-28-5"><a id="__codelineno-28-5" name="__codelineno-28-5" href="#__codelineno-28-5"></a>grep<span class="w"> </span>REDIS_URL<span class="w"> </span>.env<span class="w"> </span><span class="c1"># Should be redis://:PASSWORD@redis-changemaker:6379</span>
</span><span id="__span-28-6"><a id="__codelineno-28-6" name="__codelineno-28-6" href="#__codelineno-28-6"></a>
</span><span id="__span-28-7"><a id="__codelineno-28-7" name="__codelineno-28-7" href="#__codelineno-28-7"></a><span class="c1"># Restart Redis</span>
</span><span id="__span-28-8"><a id="__codelineno-28-8" name="__codelineno-28-8" href="#__codelineno-28-8"></a>docker<span class="w"> </span>compose<span class="w"> </span>restart<span class="w"> </span>redis
</span></code></pre></div></p>
<hr />
<h3 id="environment-variables-not-updating">Environment Variables Not Updating<a class="headerlink" href="#environment-variables-not-updating" title="Permanent link">&para;</a></h3>
<p><strong>Symptoms</strong>: Changed <code>.env</code> but service still uses old value</p>
<p><strong>Cause</strong>: Docker Compose reads <code>.env</code> at startup, not runtime</p>
<p><strong>Solution</strong>:
<div class="language-bash highlight"><pre><span></span><code><span id="__span-29-1"><a id="__codelineno-29-1" name="__codelineno-29-1" href="#__codelineno-29-1"></a><span class="c1"># Recreate container (picks up new env vars)</span>
</span><span id="__span-29-2"><a id="__codelineno-29-2" name="__codelineno-29-2" href="#__codelineno-29-2"></a>docker<span class="w"> </span>compose<span class="w"> </span>up<span class="w"> </span>-d<span class="w"> </span>--force-recreate<span class="w"> </span>api
</span><span id="__span-29-3"><a id="__codelineno-29-3" name="__codelineno-29-3" href="#__codelineno-29-3"></a>
</span><span id="__span-29-4"><a id="__codelineno-29-4" name="__codelineno-29-4" href="#__codelineno-29-4"></a><span class="c1"># Or: stop and start</span>
</span><span id="__span-29-5"><a id="__codelineno-29-5" name="__codelineno-29-5" href="#__codelineno-29-5"></a>docker<span class="w"> </span>compose<span class="w"> </span>down
</span><span id="__span-29-6"><a id="__codelineno-29-6" name="__codelineno-29-6" href="#__codelineno-29-6"></a>docker<span class="w"> </span>compose<span class="w"> </span>up<span class="w"> </span>-d
</span></code></pre></div></p>
<hr />
<h2 id="related-documentation">Related Documentation<a class="headerlink" href="#related-documentation" title="Permanent link">&para;</a></h2>
<ul>
<li><strong><a href="../docker-compose/">Docker Compose</a></strong> — Service orchestration</li>
<li><strong><a href="../ssl-tls/">SSL/TLS</a></strong> — Certificate management</li>
<li><strong><a href="../tunneling/">Tunneling</a></strong> — Pangolin setup</li>
<li><strong><a href="../backup-restore/">Backup &amp; Restore</a></strong> — Data protection</li>
<li><strong><a href="../../SECURITY_AUDIT_2025-02-11.md">Security Audit</a></strong> — Security requirements</li>
</ul>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
<button type="button" class="md-top md-icon" data-md-component="top" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
Back to top
</button>
</main>
<footer class="md-footer">
<nav class="md-footer__inner md-grid" aria-label="Footer" >
<a href="../docker-compose/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Docker Compose">
<div class="md-footer__button md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
</div>
<div class="md-footer__title">
<span class="md-footer__direction">
Previous
</span>
<div class="md-ellipsis">
Docker Compose
</div>
</div>
</a>
<a href="../nginx/" class="md-footer__link md-footer__link--next" aria-label="Next: Nginx Configuration">
<div class="md-footer__title">
<span class="md-footer__direction">
Next
</span>
<div class="md-ellipsis">
Nginx Configuration
</div>
</div>
<div class="md-footer__button md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11z"/></svg>
</div>
</a>
</nav>
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
<div class="md-copyright__highlight">
Copyright &copy; 2024 The Bunker Operations – <a href="#__consent">Change cookie settings</a>
</div>
</div>
<div class="md-social">
<a href="https://gitea.bnkops.com/admin" target="_blank" rel="noopener" title="Gitea Repository" class="md-social__link">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
</a>
<a href="https://listmonk.bnkops.com/subscription/form" target="_blank" rel="noopener" title="Newsletter" class="md-social__link">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M536.4-26.3c9.8-3.5 20.6-1 28 6.3s9.8 18.2 6.3 28l-178 496.9c-5 13.9-18.1 23.1-32.8 23.1-14.2 0-27-8.6-32.3-21.7l-64.2-158c-4.5-11-2.5-23.6 5.2-32.6l94.5-112.4c5.1-6.1 4.7-15-.9-20.6s-14.6-6-20.6-.9l-112.4 94.3c-9.1 7.6-21.6 9.6-32.6 5.2L38.1 216.8c-13.1-5.3-21.7-18.1-21.7-32.3 0-14.7 9.2-27.8 23.1-32.8z"/></svg>
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"annotate": null, "base": "../../..", "features": ["announce.dismiss", "content.action.edit", "content.action.view", "content.code.annotate", "content.code.copy", "content.tooltips", "navigation.expand", "navigation.footer", "navigation.indexes", "navigation.path", "navigation.prune", "navigation.sections", "navigation.tabs", "navigation.tabs.sticky", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
<script src="../../../assets/javascripts/bundle.79ae519e.min.js"></script>
<script src="../../../javascripts/home.js"></script>
<script src="../../../javascripts/github-widget.js"></script>
<script src="../../../javascripts/gitea-widget.js"></script>
<script src="../../../assets/js/env-config.js"></script>
<script src="../../../assets/js/video-player.js"></script>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink