Before you start
- Node 24 or newer, and git. Install both with Homebrew, or get Node from nodejs.org.Install both from PowerShell, then open a new PowerShell window.Get Node from nodejs.org or your package manager.
brew install node gitwinget install OpenJS.NodeJS.LTS Git.Git - A US bank. tally only links US banks for now.
Setting up with a coding agent?
Open it in an empty folder and paste this:
Help me install tally (https://github.com/jclind/tally) on this computer by following https://tally.jesselind.com/docs/ step by step. If you can't open that page, the same guide is site/docs/index.html in the repo. Never ask me to paste my Plaid keys into this chat: tell me which file to put them in, and I'll do it. Ask me before installing anything that runs at login.1Get Plaid keys
- Create a Plaid account and verify your email.
- Apply for the free Trial plan. Plaid offers it to teams created on or after April 15, 2026. For an older team, check the plans on your dashboard.
- Go to Developers → Keys. Copy your client_id and your Production secret.
2Install tally
There's no npm install step. On Windows, run every command in PowerShell. It opens in your user folder, which only your account can read, so keep tally there.
git clone https://github.com/jclind/tally.git
cd tallyAdd your keys
Swap in your client_id and Production secret, then run this. It writes ~/.config/tally/plaid.env, readable only by you.
mkdir -p ~/.config/tally
cat > ~/.config/tally/plaid.env <<'EOF'
PLAID_CLIENT_ID=your-client-id
PLAID_SECRET=your-production-secret
PLAID_ENV=production
EOF
chmod 600 ~/.config/tally/plaid.envSwap in your client_id and Production secret, then run this. It writes .config\tally\plaid.env in your user folder.
mkdir $HOME\.config\tally -Force | Out-Null
@'
PLAID_CLIENT_ID=your-client-id
PLAID_SECRET=your-production-secret
PLAID_ENV=production
'@ | Set-Content $HOME\.config\tally\plaid.envStart and check it
node server.mjstally on http://localhost:3400 (keys found)
If it says (keys missing), see keys missing. Otherwise open localhost:3400.
3Link your banks
Choose Link a bank or card, or Link a brokerage for investments, and sign in to your bank. Link more later from Accounts.

Try Plaid's test bank firstOptional
To look around before you link a real bank, put your Sandbox secret in the keys file instead, and restart tally:
PLAID_CLIENT_ID=your-client-id
PLAID_SECRET=your-sandbox-secret
PLAID_ENV=sandboxPick any bank and sign in with user_good and password pass_good. Test data goes in data/sandbox.db, apart from your real data, and uses none of your 10 connections. To switch back, put the Production lines back and restart.
Keep it running
On a Mac
Stop tally (Ctrl+C) first. One script then starts it at login, restarts it if it stops, and runs the daily sync at 7:00, or when the Mac wakes if it was asleep then:
bin/install-mac.shThe log is tally.log in the tally folder. For another sync time or port, add --at 06:30 or --port 3500.
On Windows
Stop tally (Ctrl+C) first. One script then starts it when you sign in, restarts it if it stops, and runs the daily sync at 7:00, or when the PC is next on if it was off then. It needs no admin rights and opens no window:
bin\install-windows.cmdThe logs are tally.log and tally-daily.log in the tally folder. For another sync time or port, add -At 06:30 or -Port 3500. To stop it for good, add -Remove.
On Linux
Run node server.mjs under systemd or another process manager, and schedule node bin/daily.mjs for the morning with cron or a timer.
Backups and updates
Copy data/tally-snapshot.db and the ~/.config/tally/ folder somewhere else, encrypted, on a schedule. tally writes the snapshot after every full sync, and it's safe to copy while tally runs.
The snapshot holds your Plaid access tokens. Without it you'd link every bank again.
Update tally
On a Mac, from your tally folder, pull the new code and restart tally:
git pull
launchctl kickstart -k gui/$(id -u)/local.tallyOn Windows, from your tally folder, pull the new code and restart tally:
git pull
bin\install-windows.cmd -RestartOn Linux, run git pull and restart the service you set up.
Settings shows the version you're running. Releases on GitHub list what changed in each one.
Use it on your phoneOptional
tally has no login, so it only listens on your computer. Tailscale lets your phone reach it over your tailnet without exposing it to the internet.
- Install Tailscale on the computer and your phone, and sign in to both with the same account.
- In Tailscale's admin console, under DNS, turn on MagicDNS and HTTPS certificates.
- On the computer, serve tally over HTTPS:
If port 443 is already in use on this computer, add
tailscale serve --bg 3400--https=8400before3400, and put:8400after the address in the next step. - Tell tally its new address.
tailscale serve statusprints the full address. On a Mac:On Windows:bin/install-mac.sh --host your-computer.your-tailnet.ts.netOn Linux, add this environment variable to the service you set up, then restart it:bin\install-windows.cmd -HostName your-computer.your-tailnet.ts.netTALLY_HOSTS=your-computer.your-tailnet.ts.net
Open https://your-computer. on your phone and add it to your home screen.
Other ways in
From another computer, an ssh tunnel needs nothing set up in tally. Run this there, then open localhost:3400:
ssh -L 3400:127.0.0.1:3400 your-computerA reverse proxy with its own login, like Caddy with a password or Cloudflare Tunnel with Access, also works. Add its address to TALLY_HOSTS, and have it pass the original Host header. That puts tally on the internet behind the proxy's login, so only do it if you trust that setup.
Discord alertsOptional
The daily job can post to a Discord channel when a charge reaches your alert amount ($200 unless you change it in Settings), a budget goes over, a goal is reached, or a bank stops syncing (weekly until it's fixed).
- In Discord, open a channel's settings, then Integrations → Webhooks, and copy a webhook URL.
- In tally, open Settings, turn on Post alerts to Discord, and paste the URL.
Using tally
- Budgets
- On Budgets, type a monthly amount next to any category you want to track; the faint number in the field is what you've spent there lately. Edit lets a budget repeat every few months (insurance, say) or roll what's left into next month, and Everything else can hold one amount for the categories you didn't budget. The tick on each bar is today, so a bar past its tick is spending ahead of the month.
- Goals
- Beside your budgets, Goals tracks one account toward an amount: savings up to $5,000, say, or a card paid down to $0. Pick a month and it shows what each month needs to get there.
- Fix a category
- On Activity, click a transaction's category and pick another. Tick Every … transaction to apply it to that merchant from now on.
- Search
- Search names, amounts, or categories.
mcdonaldsfinds McDonald's,6.75finds that exact charge, andgrocfinds Groceries. - Look back
- The month name at the top of Home, Spending, and Budgets is a menu. Pick a past month to see all of it.
- When it syncs
- tally syncs when you open it or switch back to its tab, if the data is more than 12 hours old. Sync when you open tally in Settings changes that.
Troubleshooting
The log says "keys missing"
tally reads ~/.config/tally/plaid.env, which is .config\tally\plaid.env in your user folder on Windows. Check that the file exists and has both PLAID_CLIENT_ID and PLAID_SECRET.
A bank shows an error on the Accounts page
Its sign-in expired or changed. Click Fix connection and sign in again.
A bank won't connect
Some large banks sign you in on their own site (OAuth). Check Plaid's dashboard for an OAuth institutions page; a few banks need you to request access there first. Link from the computer's own browser, not from your phone.
A bank has only a few months of history
That's what the bank gives Plaid. Some send two years, some about 90 days.
The page won't load on my phone
Run tailscale serve status on the computer, and make sure the address you passed to --host (-HostName on Windows) matches it, with :8400 only if you served on 8400. tally.log names any address tally refused.
Something else
Open an issue on GitHub with the lines from tally.log. Leave out anything with your account details.