Close Menu
IOupdate | IT News and Selfhosting
  • Home
  • News
  • Blog
  • Selfhosting
  • AI
  • Linux
  • Cyber Security
  • Gadgets
  • Gaming

Subscribe to Updates

Get the latest creative news from ioupdate about Tech trends, Gaming and Gadgets.

What's Hot
BAIR at CoRL 2026 – The Berkeley Artificial Intelligence Research Blog

BAIR at CoRL 2026 – The Berkeley Artificial Intelligence Research Blog

November 16, 2026
I put my TV and consoles on their own network, and my video calls stopped freezing

I put my TV and consoles on their own network, and my video calls stopped freezing

November 16, 2026
Lightweight Homelab Monitoring with Beszel, Docker & Portainer

Lightweight Homelab Monitoring with Beszel, Docker & Portainer

November 16, 2026
Facebook X (Twitter) Instagram
Facebook Mastodon Bluesky Reddit
IOupdate | IT News and SelfhostingIOupdate | IT News and Selfhosting
  • Home
  • News
  • Blog
  • Selfhosting
  • AI
  • Linux
  • Cyber Security
  • Gadgets
  • Gaming
IOupdate | IT News and Selfhosting
Selfhosting

How to Install Actual Budgeting Software on Debian 12 Server

AndyBy AndyMay 16, 2025Updated:November 10, 2026No Comments4 Mins Read
How to Install Actual Budgeting Software on Debian 12 Server


Self-Hosting Made Easy: How to Install Actual Budgeting System on Debian 12

Are you looking to enhance your financial management with privacy-forward solutions? In this guide, we’ll walk you through installing Actual Budgeting System on a Debian 12 server. Actual is an open-source finance management software that focuses on privacy, built with “Envelope Style Budgeting.” Let’s embark on your self-hosting journey and get your budgeting system up and running!

FAQ

  • What is Actual Budget? Actual is an open-source finance management software designed to prioritize user privacy, leveraging a popular budgeting method known as Envelope Style Budgeting.
  • Why should I self-host Actual? Self-hosting offers full control over your data, privacy, and customization, ensuring that your financial information remains secure.
  • Is Actual Budget easy to install? Yes! With the right prerequisites, you can set up Actual Budget efficiently by following our guide.

Prerequisites for Installation

Before diving into the installation, ensure you have the following:

  • A Debian 12 server
  • A non-root user with administrator privileges
  • A domain name pointing to your server’s IP address

Step 1: Installing Node.js and Yarn

To run Actual, you need to install Node.js, Git, and Yarn. As of now, Actual requires Node v18 or higher.

sudo apt update
sudo apt install nodejs npm git

Confirm the installation by entering ‘Y’. Afterward, install the Yarn package manager globally:

npm install --global yarn

Once installed, verify your Node.js and Yarn versions:

node --version
yarn --version

Step 2: Downloading Actual Budget Source Code

Now that the dependencies are set, let’s download the Actual source code and install its libraries:

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

Create a configuration file named config.json:

nano config.json

Insert the following configuration (make sure to adjust the IP and port if necessary):

{
  "hostname": "127.0.0.1",
  "port": 5006
}

Run Actual using:

yarn start

To stop the process, press Ctrl + C.

Step 3: Running Actual in the Background as a Systemd Service

To keep Actual running as a background service, create a systemd service file:

sudo nano /etc/systemd/system/actual.service

Insert the following configuration, updating the User and Group accordingly:

[Unit]
Description=Actual-Server (https://actualbudget.org)
After=network.target

[Service]
User=your_username
Group=your_username
WorkingDirectory=/home/your_username/actual-server/
ExecStart=/usr/local/bin/yarn start
Restart=on-watchdog

[Install]
WantedBy=multi-user.target

Then, enable and start the service:

sudo systemctl daemon-reload
sudo systemctl enable --now actual.service
sudo systemctl status actual.service

Step 4: Setting Up Nginx as a Reverse Proxy

Your Actual service is now running! Next, let’s configure Nginx as a reverse proxy. Install the necessary packages:

sudo apt install nginx certbot python3-certbot-nginx -y

Create a new Nginx server block file:

sudo nano /etc/nginx/sites-available/actual-budget

Input your Nginx configuration, replacing the server_name with your domain:

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        include /config/nginx/proxy.conf;
        include /config/nginx/resolver.conf;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $host;
        
        set $upstream_app 127.0.0.1;
        set $upstream_port 5006;
        set $upstream_proto http;
        
        proxy_pass $upstream_proto://$upstream_app:$upstream_port;
    }
}

To activate and check your configurations:

sudo ln -s /etc/nginx/sites-available/actual-budget /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
sudo systemctl status nginx

Step 5: Securing Your Installation with SSL via Certbot

Now, use Certbot to generate SSL certificates:

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email  -d yourdomain.com

Your Actual installation should now be secured with HTTPS!

Step 6: Accessing Actual Budget via Web Browser

Visit your domain (e.g., https://yourdomain.com) to access Actual Budget. You’ll be prompted to set up a password for your dashboard. Configure it, and then choose whether to start fresh or view demo data.

Conclusion

Congratulations! You’ve successfully installed the Actual Budgeting System, a powerful self-hosted solution, on your Debian 12 server. Now you have your financial data safeguarded while enjoying the flexibility of managing your finances.

Related guides on IOupdate

For more context on this topic, these guides cover related tools and techniques:

  • How to Install ntopng on Debian 12
  • How to Install Emby Media Server on Debian 12
  • How to Install CSF (Config Server Firewall) on Debian 12
  • How to Install Wiki.js on Debian 12

Further reading on IOupdate

  • How to Install Moodle LMS on Debian 12 Server




Read the original article

0 Like this
Actual Budgeting Debian install Server Software
Share. Facebook LinkedIn Email Bluesky Reddit WhatsApp Threads Copy Link Twitter
Previous ArticleGTA 6 delay so Rockstar could ‘achieve its creative vision with no limitations’, says Take-Two boss
Next Article The camera tech propelling shows like Adolescence

Related Posts

I put my TV and consoles on their own network, and my video calls stopped freezing
Selfhosting

I put my TV and consoles on their own network, and my video calls stopped freezing

November 16, 2026
Lightweight Homelab Monitoring with Beszel, Docker & Portainer
Selfhosting

Lightweight Homelab Monitoring with Beszel, Docker & Portainer

November 16, 2026
Is Self-Hosting Dying in Late 2026? Here’s What I Seeing for Home Labs
Selfhosting

Is Self-Hosting Dying in Late 2026? Here’s What I Seeing for Home Labs

November 10, 2026
Add A Comment
Leave A Reply Cancel Reply

Top Posts
7 Best Command-Line Text Editors for Linux

7 Best Command-Line Text Editors for Linux

November 8, 202629 Views
8 Linux Handheld Computers You Can Splurge On

8 Linux Handheld Computers You Can Splurge On

July 18, 202629 Views
WireGuard on Synology NAS: Secure Remote Access

WireGuard on Synology NAS: Secure Remote Access

May 15, 202528 Views
Stay In Touch
  • Facebook
  • Mastodon
  • Bluesky
  • Reddit

Subscribe to Updates

Get the latest creative news from ioupdate about Tech trends, Gaming and Gadgets.

About Us

Welcome to IOupdate — your trusted source for the latest in IT news and self-hosting insights. At IOupdate, we are a dedicated team of technology enthusiasts committed to delivering timely and relevant information in the ever-evolving world of information technology. Our passion lies in exploring the realms of self-hosting, open-source solutions, and the broader IT landscape.

Most Popular
7 Best Command-Line Text Editors for Linux

7 Best Command-Line Text Editors for Linux

November 8, 202629 Views
8 Linux Handheld Computers You Can Splurge On

8 Linux Handheld Computers You Can Splurge On

July 18, 202629 Views

Subscribe to Updates

Facebook Mastodon Bluesky Reddit
  • About Us
  • Contact Us
  • Disclaimer
  • Privacy Policy
  • Terms and Conditions
© 2026 ioupdate. All Right Reserved.

Type above and press Enter to search. Press Esc to cancel.