A guided installer that deploys B1Admin into your own AWS account.
You do not need to be a developer to use it. The installer asks you a short list of questions, then tells you exactly one command to run at a time, checking its own work as it goes.
👉 Read the Start Here guide — the full walkthrough, written for the person doing the installation.
The short version:
git clone https://github.com/dhempler/b1admin-installer.git
cd b1admin-installer
npm install
npm run installer:doctor # checks your computer has the required tools
npm run installer:start # tells you the next step, every timenpm run installer:start is the only command you need to remember. Run it whenever you are unsure what comes next — it looks at how far along you are and prints the next command to run.
- An AWS account you can create resources in (this will incur AWS charges — see What Costs Money). Brand new to AWS? Setting up a brand-new AWS account covers it from scratch.
- A GitHub account
- Node.js 20 or newer
- The
awsandghcommand-line tools (the doctor command checks these for you)
This repository contains only the installer — the tooling, the AWS CloudFormation templates, and the deployment workflow. It does not contain the B1Admin application code.
When you deploy, the installer pulls the application source from its own repositories at a version this installer has been tested against:
| What | Comes from |
|---|---|
| Frontend | ChurchApps/B1Admin |
| Backend API | ChurchApps/Api |
| Installer, infrastructure, workflow | this repository |
Those source versions are recorded in your customer-values.json as b1adminRef and apiRef, so an install is reproducible and an update is a deliberate choice rather than a surprise.
The installer also creates a separate private repository for you. Your AWS settings, generated secrets, and deployment records live there — never in this public repository.
Files named customer-values.json, app-config-secret.json, and bootstrap-admin-secret.json are ignored by git at any depth in this repository. They belong in your own private deployment repository, which the installer sets up for you.
- Start Here — the main installation walkthrough
- Operations After Launch — updates, backups, secrets, cost control
- First Rollout Checklist
- Setting Up A Brand-New AWS Account — from no AWS account to a working
awscommand - Setup Guides — AWS access, IAM roles, GitHub secrets, and CLI setup, one topic per page
- Your Private Repository
Email dennis.hempler@protonmail.com with B1Admin in the subject line.
B1Admin is built by ChurchApps. This installer is maintained separately so it can be updated on its own schedule; it is not an official ChurchApps project.
MIT