# CrowdSec

[Actual Budget](https://actualbudget.org/) is a privacy-focused app for managing your finances using the 'envelope' budgeting method. Plan for expenses and view a running financial report. Using a paid third-party service you can configure automatically download transaction information from your bank to keep an archive of your personal finances.

# Overview

![1000006465.png](https://hub.subspace.services/uploads/images/gallery/2025-02/1000006465.png)

[Actual Budget](https://actualbudget.org/) is a privacy-focused app for managing your finances using the 'envelope' budgeting method. Plan for expenses and view a running financial report. Using a paid third-party service you can configure automatically download transaction information from your bank to keep an archive of your personal finances.

<p class="callout success">Tryout an [Actual Budget demo](https://demo.actualbudget.org/).</p>

- Built for end-to-end encryption to ensure your data security and can run while completely offline.
- Automatically sync transactions from your bank using the third-party [GoCardless](https://gocardless.com/en-us/) or [SimpleFin](https://www.simplefin.org/) services.
- View monthly information about your finances and build personalized reports.

# Media

## Screenshots

<p class="callout info">App v1.0</p>

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%; border-width: 1px; height: 59.6px; border-color: rgb(88, 110, 117);"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">  
</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">  
</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">  
</td></tr><tr style="height: 29.8px;"><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">  
</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">  
</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">  
</td></tr></tbody></table>

# Media

## Screenshots

<p class="callout info">Cockpit v287.1-0+deb12u3</p>

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%; border-width: 1px; height: 166.45px; border-color: rgb(88, 110, 117);"><colgroup><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col></colgroup><tbody><tr style="height: 166.45px;"><td style="border-width: 1px; height: 166.45px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-27 at 19.07.12.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-27-at-19-07-12.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-27-at-19-07-12.png)</td><td style="border-width: 1px; height: 166.45px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-27 at 19.07.30.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-27-at-19-07-30.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-27-at-19-07-30.png)</td><td style="border-width: 1px; height: 166.45px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-27 at 19.07.42.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-27-at-19-07-42.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-27-at-19-07-42.png)</td></tr><tr><td style="border-width: 1px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-27 at 19.50.37.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-27-at-19-50-37.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-27-at-19-50-37.png)</td><td style="border-width: 1px; border-color: rgb(88, 110, 117);">  
</td><td style="border-width: 1px; border-color: rgb(88, 110, 117);">  
</td></tr></tbody></table>

# Setup & Configuration

We need to install the service through Portainer and configure any necessary settings.

# Preparation

There are some things we need to do in preparation to install this service.

## Volumes

<details id="bkmrk-media-folders-radarr"><summary>Persistent Data</summary>

This is where the service will store its own application data and ensures we can quickly update the service image.

<p class="callout warning">Ensure your user has permissions to access the folder.</p>

</details><details id="bkmrk-media-folders-this-s"><summary>Media Folders</summary>

This service will need access to the folders where you store your media files.

<p class="callout warning">Ensure your user has permissions to access the folder.</p>

</details><details id="bkmrk-download-folder-rada"><summary>Download Folders</summary>

This service will need access to the folder where you torrent or usenet folder store their completed downloads.

<p class="callout warning">Ensure your user has permissions to access the folder.</p>

</details>## Environment

<p class="callout info">You can find available Environmental Variables in their documentation.</p>

<details id="bkmrk-tz-this-is-the-curre"><summary>TZ</summary>

This is the current time zone formatted using the [tz database.](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)

<p class="callout info">*For example:* America/Vancouver</p>

</details><details id="bkmrk-gid-%C2%A0"><summary>PUID</summary>

This is the numeric ID of the user account on Debian. If you are unsure, open a terminal and run:

```bash
id -u
```

</details><details id="bkmrk-pgid-this-is-the-num"><summary>PGID</summary>

This is the numeric ID of the user account's group on Debian. If you are unsure, open a terminal and run:

```bash
id -g
```

</details>### Passwords

<p class="callout danger">Keep these securely stored in a password manager, such as [VaultWarden](https://hub.subspace.services/books/vaultwarden "VaultWarden").</p>

<details id="bkmrk-db_root_pass-this-is"><summary>DB\_ROOT\_PASS</summary>

This is the password that will be used for root access to the database.

<p class="callout warning">It is important to use secure, randomly generated password.</p>

You can use a random alphanumeric string from a password manager, or open the terminal and run the command:

```
tr -dc 'A-Za-z0-9!"#$%&'\''()*+,-./:;<=>?@[\]^_`{|}~' </dev/urandom | head -c 32; echo
```

This pulls a random string from the '[urandom](https://en.wikipedia.org/wiki//dev/random)' device, removes unwanted characters and trim it to an appropriate length.

</details><details id="bkmrk-owncloud_admin_passw"><summary>OWNCLOUD\_ADMIN\_PASSWORD</summary>

This is the password for the administrator account that will be used within the web interface.

<p class="callout warning">It is important to use secure passphrase that is easy-to-remember.</p>

</details>

# Installation

The service can be installed through the Portainer web interface.

<p class="callout info">Learn about [creating a new stack](https://hub.subspace.services/books/portainer/page/creating-a-new-stack "Creating a New Stack").</p>

## Docker Compose

Use the following code to install the service:

```yaml
---
services:
  actual-server:
    image: docker.io/actualbudget/actual-server:latest
    container_name: actual-server
    network_mode: bridge
    environment:
      - TZ=America/Vancouver
    volumes:
      # Persistent Data
      - /srv/actual-budget:/data
    ports:
      - 5006:5006
    restart: unless-stopped
```

## Environment

Use the following environment to configure the service using the values prepared earlier:

```bash
TZ=America/Vancouver
```

# Updating

<p class="callout success">Re-Deploy the Stack</p>

<p class="callout warning">Backup and Re-Deploy the Stack</p>

This service has been optimized for running in Docker thanks to [LinuxServer.io](https://linuxserver.io).

This allows you to [re-deploy the stack through Portainer](https://hub.subspace.services/books/portainer/page/updating-a-stack "Updating a Stack") to download the latest updates.

# User Manual

# Development

<p class="callout info">This software is released under the [MIT license](https://opensource.org/license/mit). </p>

You can learn more about how to contribute to Actual Budget through their [documentation](https://actualbudget.org/docs/contributing/).

The development team also accepts [sponsorships](https://opencollective.com/actual).

# Resources

## Official

- Official Documentation
- Official Discord
- Official Matrix
- Official Rocket.Chat
- Official Forum
- Official GitHub Repository
- Official GitLab Repository
- Official Website
- Wikipedia Entry
- Installation Guide
- Frequently Asked Questions
- General Troubleshooting

## LinuxServer.io

- Docker Image
- [Official Website](https://www.linuxserver.io/)
- [Official Documentation](https://docs.linuxserver.io/)
- [Official Discord](https://linuxserver.io/discord)
- [Official Forum](https://discourse.linuxserver.io/)
- [Official GitLab Repository ](https://gitlab.com/Linuxserver.io)
- [Frequently Asked Questions](https://docs.linuxserver.io/FAQ/)