Deploy your own copy

In this tutorial we deploy Nuits Receipts into your own Cloudflare account and sign in to it for the first time. At the end you will have your own copy running on a workers.dev address, showing its Welcome page and ready for your first receipt.

It takes about ten minutes, most of it waiting for the first build.

Before you start

You need:

A Cloudflare account.
R2 turned on in that account, with a payment method added. Cloudflare asks for one even if your use stays inside R2’s free allowance. Without it, the deploy cannot create the bucket for your originals.
A GitHub or GitLab account. Cloudflare copies the code into it.
A new password of at least 16 characters that you use nowhere else. To make one, run this in a terminal and copy the output:
```
openssl rand -base64 24
```

Keep the password somewhere safe, such as your password manager. You need it in a few minutes.

Open the deploy page

Open this link: Deploy Nuits Receipts to Cloudflare.

Connect your Git account

Connect the GitHub or GitLab account you want the copy to live in, and pick a name for the new repository. Cloudflare will copy the Nuits Receipts code into it, and every later build comes from that copy.

Keep the suggested names

The deploy page lists what it is about to create in your account:

a Worker called my-nuits-receipts
a D1 database called my-nuits-receipts
an R2 bucket called my-nuits-receipts-originals

You can rename them, but for this tutorial we keep the names as they are.

Set your password

The page asks for NUITS_PASSWORD. Paste the password you made earlier.

Below it are optional variables such as AUTH_USERNAME, PRODUCTS_JSON and ACCOUNTANT_LABEL. Leave them all as they are. You can change most of them later in the app’s Settings.

Deploy

Start the deploy with the button at the bottom of the page.

Cloudflare creates the database and the bucket, copies the code into your Git account and starts the first build. The build runs bun run deploy, which applies the database schema and then deploys the Worker. You can watch its log on the page.

When the build finishes, Cloudflare shows your Worker’s address. It looks like https://my-nuits-receipts.<your-subdomain>.workers.dev.

Open your Worker’s address in the browser. The browser asks for a user name and password:

User name: owner
Password: the password you set above

The app opens on Welcome. At the top is Finish setting up, a short list of what a new copy still needs, such as Add your business name. Under it is the Add form, which asks What are these? and has an Upload button.

The sidebar starts with an Add button, then Home, Receipts, Bank and Settings. On a phone, the same five are in a tab bar at the bottom, with Add as the round button in the middle.

What we did

You now have your own copy of Nuits Receipts in your Cloudflare account, with a private database and a private bucket for originals, protected by your password.

Next, put a month through it with sample files in Your first month. When you want receipts to arrive by email, follow Set up email. To open the app like any other app on your phone or computer, follow Install the app.