Destinations
Actual Budget
Actual Budget is a privacy-focused, local-first app for managing your finances using the envelope budgeting methodology.
Prerequisites
- An operational Actual Budget instance (self-hosted or provider-hosted)
- At least one bank account connected in Lunch Flow
- Node.js installed on your machine
Currently, the integration requires running a sync script called actual-flow locally. A direct API integration is planned for a future release.
Setup
Get your Lunch Flow API token
In Lunch Flow, go to Destinations → Add Destination → API and save the generated token securely.
Gather your Actual Budget details
You'll need:
- Your Actual Budget server URL
- Your instance password
- Your Sync ID (found in Settings → Advanced Settings)
Run the installation script
npx @lunchflow/actual-flowThe script will prompt for your API token, server URL, password, and Sync ID, then run the first sync automatically.
Optional: automate daily syncing
Set up a cron job or scheduled task to run the script daily.
FAQ
How is this guide?