From e387f4ca1cf09d6d16b431f72d29d570bd0523bc Mon Sep 17 00:00:00 2001 From: James Long <longster@gmail.com> Date: Thu, 28 Apr 2022 22:19:23 -0400 Subject: [PATCH] readme --- README.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..34359d5 --- /dev/null +++ b/README.md @@ -0,0 +1,33 @@ + +This is the main project to run [Actual](XXX), 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](https://fly.io) which makes it incredibly easy and provides a free plan. + +[Create an account](https://fly.io/app/sign-in). 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`](https://fly.io/docs/flyctl/installing/) 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. \ No newline at end of file -- GitLab