Civicsmith installer
Do you already have a Cloudflare account?
Cloudflare is the company whose computers will run your team's Civicsmith, in an account your team controls. If you don't have one, or aren't sure it's ready, the installer walks you through it step by step.
Step 1 of 4
Open a Cloudflare account and confirm its email
Your team's Civicsmith runs in this account, so open it for your team: use an email your team shares, not one person's own.
Go to dash.cloudflare.com/sign-up, enter the email and a password, and create the account. Cloudflare then emails that address: open the message and press its link to confirm it.
Nothing: opening the account is free.
When you go on, the installer checks that each step is done. If one isn't, it stops before creating anything and offers Check again.
Questions people ask
Why does my team need its own Cloudflare account?
So that nobody else holds your team's work: the people who make Civicsmith keep none of it and can't open your account. Whoever can sign in to the account controls your team's Civicsmith, so use an account that belongs to your team, and add a second trusted person to it.
What does it cost, who is paid, and how do we stop paying?
About $5 a month for Workers Paid, and R2 storage beyond the 10 GB Cloudflare includes, all paid to Cloudflare only. Nothing is paid to the people who make Civicsmith. To stop paying, cancel Workers Paid in Cloudflare's dashboard. Your team's Civicsmith stops working when the plan ends, so agree on it as a team first.
What can Civicsmith see and do in our account, and how do we remove it?
The installer can create and update your team's Civicsmith's own programs and storage, and nothing else, and it keeps no access afterward. To remove your team's Civicsmith, use the installer's page, or delete its parts in Cloudflare's dashboard, in Workers & Pages and in R2.
Is our card shared with Civicsmith?
No. Your payment method stays with Cloudflare. The installer never sees it, and the permission you give can't reach billing.
What if we already use Cloudflare?
Use that account if it belongs to your team: your team's Civicsmith is added beside what's already there under its own names, nothing else is changed, and the installer checks there is room. If the account is one person's, open a separate one for the team. If it already holds a Civicsmith, the installer says so and asks what you'd like to do.
What if we get stuck?
Close the installer at any step and come back: it opens where you left off, and nothing is lost. Cloudflare's own help pages explain each of its steps, and when something is missing, the installer says exactly what.
You can close this page at any step. Come back to this address and it opens at the step you were on.
Step 2 of 4
Choose Workers Paid and add a payment method
Workers Paid is the Cloudflare plan that can run every part of your team's Civicsmith, the file scanner and the safe view for risky files included. The free plan can't.
In Cloudflare, open Workers & Pages, then Plans, and choose Workers Paid. Add a card or another payment method when Cloudflare asks for one.
About $5 a month, paid to Cloudflare from your payment method, never to the people who make Civicsmith. You can cancel it in the same place.
When you go on, the installer checks that each step is done. If one isn't, it stops before creating anything and offers Check again.
Questions people ask
Why does my team need its own Cloudflare account?
So that nobody else holds your team's work: the people who make Civicsmith keep none of it and can't open your account. Whoever can sign in to the account controls your team's Civicsmith, so use an account that belongs to your team, and add a second trusted person to it.
What does it cost, who is paid, and how do we stop paying?
About $5 a month for Workers Paid, and R2 storage beyond the 10 GB Cloudflare includes, all paid to Cloudflare only. Nothing is paid to the people who make Civicsmith. To stop paying, cancel Workers Paid in Cloudflare's dashboard. Your team's Civicsmith stops working when the plan ends, so agree on it as a team first.
What can Civicsmith see and do in our account, and how do we remove it?
The installer can create and update your team's Civicsmith's own programs and storage, and nothing else, and it keeps no access afterward. To remove your team's Civicsmith, use the installer's page, or delete its parts in Cloudflare's dashboard, in Workers & Pages and in R2.
Is our card shared with Civicsmith?
No. Your payment method stays with Cloudflare. The installer never sees it, and the permission you give can't reach billing.
What if we already use Cloudflare?
Use that account if it belongs to your team: your team's Civicsmith is added beside what's already there under its own names, nothing else is changed, and the installer checks there is room. If the account is one person's, open a separate one for the team. If it already holds a Civicsmith, the installer says so and asks what you'd like to do.
What if we get stuck?
Close the installer at any step and come back: it opens where you left off, and nothing is lost. Cloudflare's own help pages explain each of its steps, and when something is missing, the installer says exactly what.
You can close this page at any step. Come back to this address and it opens at the step you were on.
Step 3 of 4
Turn on R2 storage
R2 is where your team's Civicsmith keeps the documents and evidence your members collect, each exactly as it was captured.
In Cloudflare, open Storage & databases, then R2, then Overview, and complete the checkout that turns R2 on.
Cloudflare includes 10 GB of R2 storage each month at no charge, and charges about 1.5 cents a month for each GB beyond that. Cloudflare shows the price at the checkout.
When you go on, the installer checks that each step is done. If one isn't, it stops before creating anything and offers Check again.
Questions people ask
Why does my team need its own Cloudflare account?
So that nobody else holds your team's work: the people who make Civicsmith keep none of it and can't open your account. Whoever can sign in to the account controls your team's Civicsmith, so use an account that belongs to your team, and add a second trusted person to it.
What does it cost, who is paid, and how do we stop paying?
About $5 a month for Workers Paid, and R2 storage beyond the 10 GB Cloudflare includes, all paid to Cloudflare only. Nothing is paid to the people who make Civicsmith. To stop paying, cancel Workers Paid in Cloudflare's dashboard. Your team's Civicsmith stops working when the plan ends, so agree on it as a team first.
What can Civicsmith see and do in our account, and how do we remove it?
The installer can create and update your team's Civicsmith's own programs and storage, and nothing else, and it keeps no access afterward. To remove your team's Civicsmith, use the installer's page, or delete its parts in Cloudflare's dashboard, in Workers & Pages and in R2.
Is our card shared with Civicsmith?
No. Your payment method stays with Cloudflare. The installer never sees it, and the permission you give can't reach billing.
What if we already use Cloudflare?
Use that account if it belongs to your team: your team's Civicsmith is added beside what's already there under its own names, nothing else is changed, and the installer checks there is room. If the account is one person's, open a separate one for the team. If it already holds a Civicsmith, the installer says so and asks what you'd like to do.
What if we get stuck?
Close the installer at any step and come back: it opens where you left off, and nothing is lost. Cloudflare's own help pages explain each of its steps, and when something is missing, the installer says exactly what.
You can close this page at any step. Come back to this address and it opens at the step you were on.
Step 4 of 4
Sign in to Cloudflare and choose Allow
Cloudflare asks you, on its own page, whether the installer may set up your team's Civicsmith in your account. You stay in control of that permission.
On the next page, choose your team's short name, then continue to Cloudflare, sign in, and choose Allow.
Nothing: this step is free.
On Cloudflare's Allow page, the installer asks to put your team's Civicsmith's programs and storage in your account, read the account's name, set up its helper programs, and check that no log records who opens which file.
It never asks for your password, your payment method, a token or an account number, and it keeps nothing you allow once the install is done.
Questions people ask
Why does my team need its own Cloudflare account?
So that nobody else holds your team's work: the people who make Civicsmith keep none of it and can't open your account. Whoever can sign in to the account controls your team's Civicsmith, so use an account that belongs to your team, and add a second trusted person to it.
What does it cost, who is paid, and how do we stop paying?
About $5 a month for Workers Paid, and R2 storage beyond the 10 GB Cloudflare includes, all paid to Cloudflare only. Nothing is paid to the people who make Civicsmith. To stop paying, cancel Workers Paid in Cloudflare's dashboard. Your team's Civicsmith stops working when the plan ends, so agree on it as a team first.
What can Civicsmith see and do in our account, and how do we remove it?
The installer can create and update your team's Civicsmith's own programs and storage, and nothing else, and it keeps no access afterward. To remove your team's Civicsmith, use the installer's page, or delete its parts in Cloudflare's dashboard, in Workers & Pages and in R2.
Is our card shared with Civicsmith?
No. Your payment method stays with Cloudflare. The installer never sees it, and the permission you give can't reach billing.
What if we already use Cloudflare?
Use that account if it belongs to your team: your team's Civicsmith is added beside what's already there under its own names, nothing else is changed, and the installer checks there is room. If the account is one person's, open a separate one for the team. If it already holds a Civicsmith, the installer says so and asks what you'd like to do.
What if we get stuck?
Close the installer at any step and come back: it opens where you left off, and nothing is lost. Cloudflare's own help pages explain each of its steps, and when something is missing, the installer says exactly what.
You can close this page at any step. Come back to this address and it opens at the step you were on.
Create your Civicsmith team
Free software for teams that check whether government keeps its own rules and promises.
Neighborhood and issue groups, newsrooms, professional associations, and public offices checking their own work.
Two choices here, then Cloudflare. What your team needs first is on civicsmith.org.
What you need
- A Cloudflare account on the Workers Paid plan ($5 a month), with a payment method, belonging to your team rather than to one person. The installer checks both the plan and the payment method before it creates anything. If either is missing, it stops and says which. Create a Cloudflare account first if you have none.
- Running its containers: the built-in file scanner and the safe view for risky files. Without them, files are kept and shown but not scanned, and a high-risk file can't be opened.
- No Claude account: the assistant is optional. The assistant, if your team uses it, needs a Claude plan with cloud sessions, which an organization can turn off.
- About twenty minutes, at a computer.
Your team's short name
Your team has two names. Its name, such as “Lakeshore Tenants”, is what people read; you choose it in setup and can change it whenever you like. Its short name, chosen here, is the fixed label in its web addresses and beside every signature, and can never change.
Lowercase letters, digits and hyphens. It becomes the first part of your team's web address and the name of its program in your Cloudflare account. A team that wants to stay unnamed picks one that reveals nothing.
Your team's places
Each place brings its deadlines, holidays, offices and records laws, each with its source. You can change this later in Settings › Places and offices.
Let this installer into your Cloudflare account
Next you go to Cloudflare's own page, sign in there, and allow this installer to set up your team's Civicsmith in your account. Civicsmith never sees your Cloudflare password. Your short name: .
What Cloudflare will ask you to allow
- Putting your team's Civicsmith's programs in your account, and its storage for documents and evidence.
- Reading which plan your account is on.
- Running its containers: the built-in file scanner and the safe view for risky files. Without them, files are kept and shown but not scanned, and a high-risk file can't be opened.
- Joining its parts together inside your account.
- Reading your account's log settings, to check that no log records who opens which file.
You approve it on Cloudflare's own page, and you can revoke it at any time from your Cloudflare dashboard. The permission passes through this installer for the minutes the setup takes. This installer has no database and nowhere to keep it, and it is never stored.
Whoever can sign in to this Cloudflare account controls your team's Civicsmith
Whoever can sign in to the hosting account your team's Civicsmith runs in (its Cloudflare account) controls it. They can replace the one-time password, claim it again, read everything in it and lock everyone else out, and no vote of the team's administrators can stop them.
Use a team account for it, not anyone's personal login.
Add at least one other trusted person to that account.
Where possible, let someone other than the team's administrators hold it.
The same account is the way back in if the password you choose is lost: whoever holds it can open the way for your team's Civicsmith to be claimed again.
About the assistant
The assistant is optional. Its two settings are made in your team's Civicsmith when it is set up, separately, and neither is chosen for you. One is whether your team pays for it, with its own Anthropic API key, which an administrator sets there. The other is whether your team keeps its material away from AI; it is off unless an administrator turns it on and gives a reason. A member may always connect their own Claude subscription or API key, which serves only them, unless your team keeps its material away from AI. Each member is told what goes to Anthropic before their first use. This installer takes no Claude account or key, and makes no choice about the assistant.
For an organization with its own security tools (most teams skip this)
Your organization's own security tools (file scanners, safe-copy makers, sandboxes, web reputation, security log forwarding) are added in your team's Civicsmith by an administrator, at its setup or later. This installer takes no tool and no tool's key.
Only if your organization will add a security tool that your team's Civicsmith reaches through a Cloudflare Tunnel: the ID of the Workers VPC service for it, as Cloudflare shows it. The file scanner is connected to it. Left empty, none is connected, and such a tool can't be reached from your team's Civicsmith until the updater is run with one.
Prefer to do everything by hand, with nothing passing through this installer at all? The manual path is documented and permanently supported. It uses the Cloudflare dashboard directly, and it exists so that your team can stand up its Civicsmith even if the publisher of Civicsmith releases disappears.
Already running your team's Civicsmith and looking for the current release? That is the update page.
This installer is run by the publisher of Civicsmith releases.