Your Ledger, your way.

Start by creating your own copy. Open the repository, select Fork, and choose your GitHub account. You will deploy and customize your fork, not the original project.

Open the ready-made Ledger database template, select Duplicate, and choose your own Notion workspace.

Open Notion's integrations page and create a new internal integration in the same workspace where you duplicated the database.

Open your duplicated database. Select the ••• menu in the top-right corner, choose Connections, and select the integration you created.

Copy the integration token from Notion and the ID of your duplicated database. You will add both values to .env.local in the next step.

Clone your fork locally, install dependencies, and create your environment file.

git clone https://github.com/<your-username>/ledger.git
cd ledger
pnpm install
cp .env.example .env.local

Add your own values to .env.local:

NOTION_TOKEN=...
NOTION_DB_ID=...
SITE_PASSWORD=choose-a-strong-password
AUTH_SECRET=generate-a-long-random-value
LOG_TOKEN=generate-a-long-random-value
IS_DEMO=false
IS_AI_ENABLED=true
OPENAI_API_KEY=your-openai-api-key
AI_MODEL=gpt-4.1-mini

Start the development server and open the local address in your browser.

pnpm dev
# Open http://localhost:3000

Deploy the fork to the hosting platform of your choice. Add the same environment variables in its project settings, then build and start the application using the commands supported by that platform.