Skip to main content

Actual Server repository move

In February 2025 the actual-server repository will be merged into the Actual repository.

The reasons for this change are as follows:

  • Streamlines Development: Developers will only need to clone/sync one repo instead of two.
  • Improves Debugging: It makes end-to-end debugging for server/client easier as they will be in the same workspace.
  • Simplifies Desktop App Packaging: Enables the desktop app to embed the sync server.
  • Ensures code consistency and reduces the maintenance burden.
  • Simplifies the release process

Questions:

  • Q. I build the docker image locally, can I still do that?

    A. All of the docker files are still available. To build the sync server locally you can use the sync-server.Dockerfile located in the root of the repository. The docker-compose.yml is located in the /packages/sync-server directory.

  • Q. I use the Local Installation. How do I keep up to date?

    A. Follow these instructions:

    1. Clone the Actual repository. You can use the following command:
    git clone https://github.com/actualbudget/actual.git
    1. Navigate to the Actual project root directory:
    cd actual
    1. Install the required dependencies for the server:
    yarn install:server
    1. Run the server with:
    yarn start:server