Actual's server
Find a file
2022-04-28 22:21:18 -04:00
migrations initial (open-source) 2022-03-31 13:19:08 -04:00
sql initial (open-source) 2022-03-31 13:19:08 -04:00
util Add actual deps, fly config, and more 2022-04-28 22:09:40 -04:00
.dockerignore Add actual deps, fly config, and more 2022-04-28 22:09:40 -04:00
.gitignore Cleanup 2022-03-31 13:24:52 -04:00
account-db.js initial (open-source) 2022-03-31 13:19:08 -04:00
app-account.js initial (open-source) 2022-03-31 13:19:08 -04:00
app-plaid.js cleanup 2022-04-28 22:21:18 -04:00
app-sync.js Add actual deps, fly config, and more 2022-04-28 22:09:40 -04:00
app.js Add actual deps, fly config, and more 2022-04-28 22:09:40 -04:00
db.js initial (open-source) 2022-03-31 13:19:08 -04:00
Dockerfile Add actual deps, fly config, and more 2022-04-28 22:09:40 -04:00
fly.toml Add actual deps, fly config, and more 2022-04-28 22:09:40 -04:00
load-config.js Add actual deps, fly config, and more 2022-04-28 22:09:40 -04:00
package.json Add actual deps, fly config, and more 2022-04-28 22:09:40 -04:00
README.md readme 2022-04-28 22:19:23 -04:00
sync-full.js initial (open-source) 2022-03-31 13:19:08 -04:00
sync-simple.js initial (open-source) 2022-03-31 13:19:08 -04:00
yarn.lock Add actual deps, fly config, and more 2022-04-28 22:09:40 -04:00

This is the main project to run Actual, a local-first personal finance tool. It comes with the latest version of Actual, and a server to persist changes and make data available across all devices.

Running

It's very easy to get started. Clone this repo, install deps, and start it:

git clone https://github.com/actualbudget/actual-server.git
cd actual-server
yarn install
yarn start

Go to https://localhost:5006 in your browser and you'll see Actual.

Deploying

You should deploy your server so it's always running. We recommend fly.io which makes it incredibly easy and provides a free plan.

Create an account. Once you see the credit card page, you don't actually have to enter it. Just navigate to https://fly.io/apps to see the dashboard.

Next, install the flyctl utility. Run flyctl auth login to sign into your account.

Now, run flyctl deploy from actual-server. You should have a running app now!

Whenever you want to update Actual, update the versions of @actual-app/api and @actual-app/web in package.json and deploy again.

Note: if you don't want to use fly, we still provide a Dockerfile to build the app so it should work anywhere that can compile a docker image.

Non-technical users

We are looking into a feature for one-button click click deployment of Actual. This will reduce the friction for people not as comfortable with the command line.