Fixes to the map display and several other bugs
This commit is contained in:
@@ -1572,6 +1572,15 @@ Changemaker Archive. <a href="https://docs.bnkops.com">Learn more</a>
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#map" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Map
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
@@ -1586,108 +1595,6 @@ Changemaker Archive. <a href="https://docs.bnkops.com">Learn more</a>
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#getting-started" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Getting Started
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#service-dependencies" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Service Dependencies
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#environment-configuration" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Environment Configuration
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#monitoring-and-maintenance" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Monitoring and Maintenance
|
||||
</span>
|
||||
</a>
|
||||
|
||||
<nav class="md-nav" aria-label="Monitoring and Maintenance">
|
||||
<ul class="md-nav__list">
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#health-checks" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Health Checks
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#updates" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Updates
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#backups" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Backups
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</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="#common-issues" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Common Issues
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#getting-help" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Getting Help
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
@@ -1795,6 +1702,16 @@ Changemaker Archive. <a href="https://docs.bnkops.com">Learn more</a>
|
||||
<li>Simple and fast interface</li>
|
||||
<li>No user registration required</li>
|
||||
</ul>
|
||||
<h3 id="map"><a href="map/">Map</a><a class="headerlink" href="#map" title="Permanent link">¶</a></h3>
|
||||
<p><strong>Port: 3000</strong> | Canvassing and community organizing application </p>
|
||||
<div class="gitea-widget" data-repo="admin/changemaker.lite"></div>
|
||||
<ul>
|
||||
<li>Interactive map for door-to-door canvassing</li>
|
||||
<li>Location and contact management</li>
|
||||
<li>Admin panel and QR code walk sheets</li>
|
||||
<li>NocoDB integration for data storage</li>
|
||||
<li>User authentication and access control</li>
|
||||
</ul>
|
||||
<h2 id="service-architecture">Service Architecture<a class="headerlink" href="#service-architecture" title="Permanent link">¶</a></h2>
|
||||
<div class="language-text 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><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>│ Homepage │ │ Code Server │ │ MkDocs │
|
||||
@@ -1810,86 +1727,13 @@ Changemaker Archive. <a href="https://docs.bnkops.com">Learn more</a>
|
||||
</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>│ NocoDB │ │ PostgreSQL │ │ PostgreSQL │
|
||||
</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>│ :8090 │ │ (listmonk-db) │ │ (root_db) │
|
||||
</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a>└─────────────────┘ │ :5432 │ │ :5432 │
|
||||
</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a> │ └─────────────────┘ └─────────────────┘
|
||||
</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a> └──────────────────────────────────────────────────────┘
|
||||
</span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a> └─────────────────┘ └─────────────────┘
|
||||
</span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>
|
||||
</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>┌─────────────────┐
|
||||
</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a>│ Map │
|
||||
</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>│ :3000 │
|
||||
</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>└─────────────────┘
|
||||
</span></code></pre></div>
|
||||
<h2 id="getting-started">Getting Started<a class="headerlink" href="#getting-started" title="Permanent link">¶</a></h2>
|
||||
<ol>
|
||||
<li><strong>Start all services</strong>: <code>docker compose up -d</code></li>
|
||||
<li><strong>Check service status</strong>: <code>docker compose ps</code></li>
|
||||
<li><strong>View logs</strong>: <code>docker compose logs [service-name]</code></li>
|
||||
<li><strong>Stop services</strong>: <code>docker compose down</code></li>
|
||||
</ol>
|
||||
<h2 id="service-dependencies">Service Dependencies<a class="headerlink" href="#service-dependencies" title="Permanent link">¶</a></h2>
|
||||
<ul>
|
||||
<li><strong>Listmonk</strong> depends on <strong>PostgreSQL</strong> (listmonk-db)</li>
|
||||
<li><strong>NocoDB</strong> depends on <strong>PostgreSQL</strong> (root_db)</li>
|
||||
<li><strong>Static Server</strong> serves content built by <strong>MkDocs</strong></li>
|
||||
<li><strong>n8n</strong> can integrate with all other services</li>
|
||||
<li>All services share the <code>changemaker</code> network</li>
|
||||
</ul>
|
||||
<h2 id="environment-configuration">Environment Configuration<a class="headerlink" href="#environment-configuration" title="Permanent link">¶</a></h2>
|
||||
<p>Services are configured through environment variables in your <code>.env</code> file:</p>
|
||||
<div class="language-text highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a># Port configurations
|
||||
</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>CODE_SERVER_PORT=8888
|
||||
</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a>LISTMONK_PORT=9000
|
||||
</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a>LISTMONK_DB_PORT=5432
|
||||
</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a>MKDOCS_PORT=4000
|
||||
</span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a>MKDOCS_SITE_SERVER_PORT=4001
|
||||
</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>N8N_PORT=5678
|
||||
</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a>
|
||||
</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a># User and group IDs
|
||||
</span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a>USER_ID=1000
|
||||
</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a>GROUP_ID=1000
|
||||
</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a>
|
||||
</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a># Database configuration
|
||||
</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a>POSTGRES_USER=listmonk
|
||||
</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a>POSTGRES_PASSWORD=your_password
|
||||
</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a>POSTGRES_DB=listmonk
|
||||
</span><span id="__span-1-17"><a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a>
|
||||
</span><span id="__span-1-18"><a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a># n8n configuration
|
||||
</span><span id="__span-1-19"><a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a>N8N_ENCRYPTION_KEY=your_encryption_key
|
||||
</span><span id="__span-1-20"><a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a>N8N_USER_EMAIL=admin@example.com
|
||||
</span><span id="__span-1-21"><a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a>N8N_USER_PASSWORD=your_password
|
||||
</span></code></pre></div>
|
||||
<h2 id="monitoring-and-maintenance">Monitoring and Maintenance<a class="headerlink" href="#monitoring-and-maintenance" title="Permanent link">¶</a></h2>
|
||||
<h3 id="health-checks">Health Checks<a class="headerlink" href="#health-checks" title="Permanent link">¶</a></h3>
|
||||
<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="c1"># Check all services</span>
|
||||
</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>docker<span class="w"> </span>compose<span class="w"> </span>ps
|
||||
</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>
|
||||
</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="c1"># Check specific service logs</span>
|
||||
</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a>docker<span class="w"> </span>compose<span class="w"> </span>logs<span class="w"> </span>listmonk-app
|
||||
</span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a>docker<span class="w"> </span>compose<span class="w"> </span>logs<span class="w"> </span>code-server
|
||||
</span></code></pre></div>
|
||||
<h3 id="updates">Updates<a class="headerlink" href="#updates" title="Permanent link">¶</a></h3>
|
||||
<div class="language-bash highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="c1"># Pull latest images</span>
|
||||
</span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>docker<span class="w"> </span>compose<span class="w"> </span>pull
|
||||
</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a>
|
||||
</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="c1"># Restart with new images</span>
|
||||
</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a>docker<span class="w"> </span>compose<span class="w"> </span>down<span class="w"> </span><span class="o">&&</span><span class="w"> </span>docker<span class="w"> </span>compose<span class="w"> </span>up<span class="w"> </span>-d
|
||||
</span></code></pre></div>
|
||||
<h3 id="backups">Backups<a class="headerlink" href="#backups" title="Permanent link">¶</a></h3>
|
||||
<ul>
|
||||
<li><strong>PostgreSQL</strong>: Regular database backups</li>
|
||||
<li><strong>n8n</strong>: Export workflows and credentials</li>
|
||||
<li><strong>Code Server</strong>: Backup configuration and workspace</li>
|
||||
<li><strong>MkDocs</strong>: Version control your documentation</li>
|
||||
</ul>
|
||||
<h2 id="troubleshooting">Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permanent link">¶</a></h2>
|
||||
<h3 id="common-issues">Common Issues<a class="headerlink" href="#common-issues" title="Permanent link">¶</a></h3>
|
||||
<ol>
|
||||
<li><strong>Port Conflicts</strong>: Ensure ports are not used by other applications</li>
|
||||
<li><strong>Permission Issues</strong>: Check <code>USER_ID</code> and <code>GROUP_ID</code> settings</li>
|
||||
<li><strong>Network Issues</strong>: Verify services can communicate through the <code>changemaker</code> network</li>
|
||||
<li><strong>Data Persistence</strong>: Ensure volumes are properly mounted</li>
|
||||
</ol>
|
||||
<h3 id="getting-help">Getting Help<a class="headerlink" href="#getting-help" title="Permanent link">¶</a></h3>
|
||||
<ul>
|
||||
<li>Check individual service documentation</li>
|
||||
<li>Review container logs for error messages</li>
|
||||
<li>Verify environment variable configuration</li>
|
||||
<li>Test network connectivity between services</li>
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user