tally

Install guide

Get Plaid keys, install tally, and link your banks. To look around first, try Plaid's test bank.

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 git
    winget 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

  1. Create a Plaid account and verify your email.
  2. 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.
  3. Go to Developers → Keys. Copy your client_id and your Production secret.
Don't apply for full Production access. Plaid ends the free Trial once you submit a Production application, and you can't go back.

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 tally

Add 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.env

Swap 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.env

Start and check it

node server.mjs
Expected output
tally on http://localhost:3400 (keys found)

If it says (keys missing), see keys missing. Otherwise open localhost:3400.

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=sandbox

Pick 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.sh

The 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.cmd

The 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.tally

On Windows, from your tally folder, pull the new code and restart tally:

git pull
bin\install-windows.cmd -Restart

On 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.

  1. Install Tailscale on the computer and your phone, and sign in to both with the same account.
  2. In Tailscale's admin console, under DNS, turn on MagicDNS and HTTPS certificates.
  3. On the computer, serve tally over HTTPS:
    tailscale serve --bg 3400
    If port 443 is already in use on this computer, add --https=8400 before 3400, and put :8400 after the address in the next step.
  4. Tell tally its new address. tailscale serve status prints the full address. On a Mac:
    bin/install-mac.sh --host your-computer.your-tailnet.ts.net
    On Windows:
    bin\install-windows.cmd -HostName your-computer.your-tailnet.ts.net
    On Linux, add this environment variable to the service you set up, then restart it:
    TALLY_HOSTS=your-computer.your-tailnet.ts.net

Open https://your-computer.your-tailnet.ts.net 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-computer

A 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.

Never use Tailscale Funnel or a port forward for tally. Either one puts your accounts on the public internet with no password.

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).

  1. In Discord, open a channel's settings, then Integrations → Webhooks, and copy a webhook URL.
  2. 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. mcdonalds finds McDonald's, 6.75 finds that exact charge, and groc finds 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.