<h1id="changemaker-control-panel-ccp">Changemaker Control Panel (CCP)<aclass="headerlink"href="#changemaker-control-panel-ccp"title="Permanent link">¶</a></h1>
<divclass="admonition tip">
<pclass="admonition-title">Need help getting set up?</p>
<p><strong>Bunker Operations</strong> provides managed infrastructure and hands-on setup assistance for organizations running Changemaker Lite. We handle domains, tunnels, SMTP, and servers so you can focus on your campaign. <strong>Get in touch:</strong><ahref="https://bnkops.com">bnkops.com</a> | <code>admin@bnkops.ca</code></p>
</div>
<p>The Changemaker Control Panel is a <strong>multi-tenant management layer</strong> for operators who run multiple Changemaker Lite instances from a single server. It provides a web UI to provision, monitor, and maintain a fleet of instances without manual configuration.</p>
<pclass="admonition-title">Need help getting set up?</p>
<p><strong>Bunker Operations</strong> provides managed infrastructure and hands-on setup assistance for organizations running Changemaker Lite. We handle domains, tunnels, SMTP, and servers so you can focus on your campaign. <strong>Get in touch:</strong><ahref="https://bnkops.com">bnkops.com</a> | <code>admin@bnkops.ca</code></p>
</div>
<p>Changemaker Lite uses a single <code>.env</code> file at the project root to configure all services. Copy the example file to get started:</p>
<h1id="features-at-a-glance">Features at a Glance<aclass="headerlink"href="#features-at-a-glance"title="Permanent link">¶</a></h1>
<divclass="admonition tip">
<pclass="admonition-title">Need help getting set up?</p>
<p><strong>Bunker Operations</strong> provides managed infrastructure and hands-on setup assistance for organizations running Changemaker Lite. We handle domains, tunnels, SMTP, and servers so you can focus on your campaign. <strong>Get in touch:</strong><ahref="https://bnkops.com">bnkops.com</a> | <code>admin@bnkops.ca</code></p>
</div>
<p>Changemaker Lite bundles advocacy campaigns, geographic mapping, volunteer management, media hosting, and landing pages into a single self-hosted platform. Every feature can be toggled on or off from <strong>Settings</strong> in the admin panel.</p>
<pclass="admonition-title">Need help getting set up?</p>
<p><strong>Bunker Operations</strong> provides managed infrastructure and hands-on setup assistance for organizations running Changemaker Lite. We handle domains, tunnels, SMTP, and servers so you can focus on your campaign. <strong>Get in touch:</strong><ahref="https://bnkops.com">bnkops.com</a> | <code>admin@bnkops.ca</code></p>
</div>
<p>You've installed Changemaker Lite — here's what to do next.</p>
<p>Changemaker Lite is a self-hosted campaign platform that runs entirely on Docker. This guide takes you from zero to a working deployment — whether you're evaluating locally or launching for a live campaign.</p>
<divclass="admonition tip">
<pclass="admonition-title">Need help getting set up?</p>
<p><strong>Bunker Operations</strong> provides managed infrastructure and hands-on setup assistance for organizations running Changemaker Lite. We handle domains, tunnels, SMTP, and servers so you can focus on your campaign. <strong>Get in touch:</strong><ahref="https://bnkops.com">bnkops.com</a> | <code>admin@bnkops.ca</code></p>
<p>Before deploying, gather the essentials. The requirements differ depending on whether you're running a <strong>quick local test</strong> or a <strong>production deployment</strong> serving real users.</p>
<p>Changemaker Lite uses <strong>subdomain routing</strong> — <code>app.</code>, <code>api.</code>, <code>docs.</code>, <code>git.</code>, and 10+ more subdomains are created automatically. Wildcard DNS (<code>*.yourdomain.org</code>) is the simplest approach.</p>
<p>Your server needs to be reachable from the internet. Built-in support for <strong><ahref="https://github.com/fosrl/pangolin">Pangolin</a></strong> — a self-hosted tunnel with SSL, subdomain routing, and access control. The admin dashboard includes a one-click setup wizard.</p>
<p><em>Alternatives: Cloudflare Tunnel, a VPS with public IP, or any reverse proxy with SSL.</em></p>
<p>Any Linux with Docker. Ubuntu 22.04+ LTS recommended. A VPS from <ahref="https://www.digitalocean.com">DigitalOcean</a>, <ahref="https://www.hetzner.com">Hetzner</a>, or <ahref="https://www.linode.com">Linode</a> works great — or a spare machine on your network if using a tunnel.</p>
</li>
</ul>
</div>
<detailsclass="info">
<summary>Optional services that enhance your deployment</summary>
<p>These aren't required but unlock additional features:</p>
<td><strong><ahref="https://www.mapbox.com/pricing">Mapbox</a></strong> or <strong><ahref="https://developers.google.com/maps">Google Maps</a></strong></td>
<td>Better geocoding accuracy for mapping</td>
<td>100K req/mo (Mapbox) or $200/mo credit (Google)</td>
<p>This downloads a lightweight release package (~2 MB), runs the configuration wizard, and pulls pre-built Docker images. First startup takes ~2 minutes. See <ahref="installation/#pre-built-image-installation">Installation</a> for details.</p>
<p>Open <strong>http://localhost:3000</strong> and sign in with the admin email and password you configured. The API container automatically runs database migrations and seeding on first startup — no manual steps needed.</p>
<p>Open <strong>http://localhost:3000</strong> and sign in with the admin credentials you configured. The API container automatically runs database migrations and seeding on first startup.</p>
<divclass="admonition warning">
<pclass="admonition-title">Change your password</p>
<p>If you used the wizard's generated password, change it immediately from the admin dashboard.</p>
</div>
<p>For the full setup walkthrough, see <ahref="installation/">Installation</a>.</p>
<liclass="task-list-item"><labelclass="task-list-control"><inputtype="checkbox"disabled/><spanclass="task-list-indicator"></span></label><strong>Domain name</strong> registered and DNS accessible</li>
<liclass="task-list-item"><labelclass="task-list-control"><inputtype="checkbox"disabled/><spanclass="task-list-indicator"></span></label><strong>DNS configured</strong> — wildcard <code>*.yourdomain.org</code> or individual subdomains pointing to your tunnel/server</li>
<liclass="task-list-item"><labelclass="task-list-control"><inputtype="checkbox"disabled/><spanclass="task-list-indicator"></span></label><strong>Tunnel or public IP</strong> — Pangolin credentials (API key + Org ID), or server with public IP + SSL</li>
<liclass="task-list-item"><labelclass="task-list-control"><inputtype="checkbox"disabled/><spanclass="task-list-indicator"></span></label><strong>SMTP credentials</strong> — host, port, username, password from your email provider</li>
<liclass="task-list-item"><labelclass="task-list-control"><inputtype="checkbox"disabled/><spanclass="task-list-indicator"></span></label><em>(Optional)</em> Stripe account for payments</li>
<liclass="task-list-item"><labelclass="task-list-control"><inputtype="checkbox"disabled/><spanclass="task-list-indicator"></span></label><em>(Optional)</em> Mapbox or Google Maps API key for geocoding</li>
<liclass="task-list-item"><labelclass="task-list-control"><inputtype="checkbox"disabled/><spanclass="task-list-indicator"></span></label><em>(Optional)</em> MaxMind account for geographic analytics</li>
</ul>
<hr/>
<h2id="services-at-a-glance">Services at a Glance<aclass="headerlink"href="#services-at-a-glance"title="Permanent link">¶</a></h2>
<p>Changemaker Lite includes <strong>30+ Docker services</strong> organized into 8 categories:</p>
<pclass="admonition-title">Need help getting set up?</p>
<p><strong>Bunker Operations</strong> provides managed infrastructure and hands-on setup assistance for organizations running Changemaker Lite. We handle domains, tunnels, SMTP, and servers so you can focus on your campaign. <strong>Get in touch:</strong><ahref="https://bnkops.com">bnkops.com</a> | <code>admin@bnkops.ca</code></p>
</div>
<p>Changemaker Lite runs as a set of Docker containers orchestrated by Docker Compose. The <code>config.sh</code> wizard handles all configuration — or you can set things up manually.</p>
<divclass="admonition info">
<pclass="admonition-title">Have your external services ready?</p>
<h1id="prerequisites-external-services">Prerequisites & External Services<aclass="headerlink"href="#prerequisites-external-services"title="Permanent link">¶</a></h1>
<divclass="admonition tip">
<pclass="admonition-title">Need help getting set up?</p>
<p><strong>Bunker Operations</strong> provides managed infrastructure and hands-on setup assistance for organizations running Changemaker Lite. We handle domains, tunnels, SMTP, and servers so you can focus on your campaign. <strong>Get in touch:</strong><ahref="https://bnkops.com">bnkops.com</a> | <code>admin@bnkops.ca</code></p>
</div>
<p>Before running the installer, gather the external services and accounts listed below. Having these ready makes the configuration wizard a smooth, uninterrupted process.</p>
<divclass="admonition tip">
<pclass="admonition-title">Don't have these yet?</p>
<pclass="admonition-title">Built by organizers, for organizers</p>
<p>Bunker Operations exists so campaign teams can focus on <strong>building power</strong> — not wrestling with infrastructure. We provide the plumbing so you can focus on the mission.</p>
<p><strong>Get in touch:</strong><ahref="https://bnkops.com">bnkops.com</a>or email<code>hello@bnkops.com</code></p>
<p><strong>Get in touch:</strong><ahref="https://bnkops.com">bnkops.com</a>|<code>admin@bnkops.ca</code></p>
<pclass="admonition-title">Need help getting set up?</p>
<p><strong>Bunker Operations</strong> provides managed infrastructure and hands-on setup assistance for organizations running Changemaker Lite. We handle domains, tunnels, SMTP, and servers so you can focus on your campaign. <strong>Get in touch:</strong><ahref="https://bnkops.com">bnkops.com</a> | <code>admin@bnkops.ca</code></p>
</div>
<p>Changemaker Lite runs as <strong>30+ Docker containers</strong> orchestrated by Docker Compose. This page catalogs every service, organized by category.</p>
<h1id="updates-upgrades">Updates & Upgrades<aclass="headerlink"href="#updates-upgrades"title="Permanent link">¶</a></h1>
<divclass="admonition tip">
<pclass="admonition-title">Need help getting set up?</p>
<p><strong>Bunker Operations</strong> provides managed infrastructure and hands-on setup assistance for organizations running Changemaker Lite. We handle domains, tunnels, SMTP, and servers so you can focus on your campaign. <strong>Get in touch:</strong><ahref="https://bnkops.com">bnkops.com</a> | <code>admin@bnkops.ca</code></p>
</div>
<p>Changemaker Lite includes a built-in upgrade system that pulls code updates, rebuilds containers, runs database migrations, and restarts services — all while preserving your customizations.</p>
<p>There are two ways to upgrade:</p>
<ol>
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
