So installieren Sie die Actual Budgeting Software auf einem Debian 12 Server

Actual Budget ist eine Open-Source-Software zur Finanzverwaltung, die sich auf Datenschutz konzentriert und auf “Envelope Style Budgeting” basiert. Actual ist in Node.js geschrieben und kann in kürzester Zeit lokal installiert werden. Es unterstützt die Synchronisierung über mehrere Geräte und bietet optionale End-to-End-Verschlüsselung.

In diesem Tutorial zeigen wir Ihnen, wie Sie das Actual Budgeting System auf dem Debian 12 Server installieren. Sie installieren Actual mit Nginx als Reverse-Proxy und sichern es mit HTTPS über Certbot und Letsencrypt.

Voraussetzungen

Um mit diesem Tutorial zu beginnen, stellen Sie sicher, dass Sie:

• Einen Debian 12 Server
• Einen Nicht-Root-Benutzer mit Administratorrechten
• Einen Domainnamen, der auf die Server-IP-Adresse verweist

Installation von Node.js und Yarn

Bevor Sie Actual installieren, müssen Sie sicherstellen, dass Node.js, Git und der Yarn-Paketmanager auf Ihrem System installiert sind. Derzeit benötigt Actual Node v18 oder höher, das aus dem offiziellen Debian-Repository installiert werden kann.

Zuerst führen Sie den Befehl ‘ apt ‘ unten aus, um Ihr Debian-Paket-Index zu aktualisieren und grundlegende Pakete wie Node.js, NPM und Git zu installieren. Geben Sie ‘ Y ‘ ein, um die Installation zu bestätigen.

sudo apt update  
sudo apt install nodejs npm git

Nachdem die Installation abgeschlossen ist, installieren Sie den Yarn-Paketmanager mit dem Befehl ‘ npm ‘ unten. In diesem Beispiel installieren Sie Yarn global oder systemweit.

npm install --global yarn

Wenn Sie fertig sind, überprüfen Sie die Version von Node.js und Yarn mit dem folgenden Befehl.

node --version  
yarn --version

Im folgenden Output können Sie sehen, dass Node.js 18 und Yarn 1.22 installiert sind.

Herunterladen des Actual Budget Quellcodes

Nachdem die Abhängigkeiten installiert sind, sind Sie bereit, den Actual Quellcode herunterzuladen, Abhängigkeiten über Yarn zu installieren, Actual mit der Datei ‘config.json’ zu konfigurieren und dann Actual über die Befehlszeile auszuführen. Außerdem benötigen Sie einen dedizierten Benutzer, um Actual auf Ihrem System zu installieren und auszuführen.

Melden Sie sich mit dem folgenden Befehl bei Ihrem Benutzer an.

su - username

Laden Sie den Actual Budget Quellcode mit dem Befehl ‘ git ‘ unten herunter.

git clone https://github.com/actualbudget/actual-server.git

Gehen Sie in das Verzeichnis ‘ actual-server ‘ und installieren Sie die JavaScript-Abhängigkeiten mit dem Befehl ‘ yarn ‘ unten.

cd actual-server  
yarn install

Sie können unten die Installation der JavaScript-Abhängigkeiten über den Yarn-Paketmanager sehen.

Nachdem die Installation abgeschlossen ist, erstellen Sie eine neue Datei ‘ config.json ‘ mit dem Editor ‘ nano ‘.

nano config.json

Fügen Sie die folgende Konfiguration ein, um Actual auf der lokalen IP-Adresse mit dem Standardport 5006 auszuführen.

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

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie schließlich den Befehl ‘ yarn start ‘ unten aus, um die Actual-Software zu starten. Dies öffnet den Port 5006 auf Ihrer localhost- oder ‘ 127.0.0.1 ‘ Adresse, die von der Anwendung verwendet wird.

yarn start

Drücken Sie Ctrl+c, um den Prozess zu beenden.

Ausführen von Actual im Hintergrund als Systemd-Dienst

Jetzt, da Sie Actual installiert und konfiguriert haben, erstellen wir eine neue Systemd-Dienstdatei, um Actual im Hintergrund als Systemd-Dienst auszuführen.

Erstellen Sie eine neue Systemd-Dienstdatei ‘ /etc/systemd/system/actual.service ‘ mit dem folgenden Editor ‘ nano ‘.

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

Fügen Sie die folgende Konfiguration ein, um Actual im Hintergrund als Systemd-Dienst auszuführen. Stellen Sie sicher, dass Sie den Standard ‘ User ‘ und ‘ Group ‘ mit Ihrem Benutzernamen ändern, und ändern Sie dann das ‘ WorkingDirectory ‘ mit Ihrem richtigen Pfad.

[Unit]  
Description=Actual-Server (https://actualbudget.org)  
After=network.target  
  
[Service]  
User=flash  
Group=flash  
WorkingDirectory=/home/flash/actual-server/  
ExecStart=/usr/local/bin/yarn start  
Restart=on-watchdog  
  
[Install]  
WantedBy=multi-user.target

Speichern Sie die Datei und beenden Sie den Editor, wenn Sie fertig sind.

Führen Sie jetzt den Befehl ‘ systemctl ‘ unten aus, um den Systemd-Manager neu zu laden und Ihre Änderungen anzuwenden.

sudo systemctl daemon-reload

Und dann starten und aktivieren Sie den ‘ actual.service ‘ mit dem folgenden Befehl. Dies wird den ‘ actual.service ‘ im Hintergrund starten und aktivieren, damit er beim Systemstart automatisch ausgeführt wird.

sudo systemctl enable --now actual.service

Überprüfen Sie den Status des ‘ actual.service ‘ mit dem folgenden Befehl. Sie sollten sehen, dass der ‘ actual.service ‘ auf Ihrem System läuft und aktiviert ist.

sudo systemctl status actual.service

Einrichten von Nginx als Reverse-Proxy

An diesem Punkt läuft Actual im Hintergrund als Systemd-Dienst. In diesem Abschnitt installieren Sie Nginx und konfigurieren ihn als Reverse-Proxy für Actual. Danach generieren Sie SSL-Zertifikate für Ihre Actual-Bereitstellung über Certbot und Letsencrypt.

Zuerst führen Sie den Befehl ‘ apt ‘ unten aus, um Nginx, Certbot und das Python3 Certbot Nginx-Plugin zu installieren. Geben Sie ‘ Y ‘ ein, um mit der Installation fortzufahren.

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

Nachdem die Installation abgeschlossen ist, erstellen Sie eine neue Nginx-Serverblockdatei ‘ /etc/nginx/sites-available/actual-budget ‘ mit dem Editor ‘ nano ‘.

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

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie den Parameter ‘ server_name ‘ mit Ihrem Domainnamen ändern.

server {  
listen 80;  
server_name budget.howtoforge.local;  
  
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;  
}  
}

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

Führen Sie jetzt den Befehl unten aus, um den ‘ actual-budget ‘ Serverblock zu aktivieren und Ihre Nginx-Konfigurationen zu überprüfen. Wenn kein Fehler auftritt, erhalten Sie eine Ausgabe wie ‘ syntax is ok - test is successful ‘.

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

Als nächstes führen Sie den Befehl unten aus, um den Nginx-Dienststatus neu zu starten und zu überprüfen. Stellen Sie sicher, dass der Nginx-Webserver läuft.

sudo systemctl restart nginx  
sudo systemctl status nginx

Zuletzt führen Sie den Befehl ‘ certbot ‘ unten aus, um SSL-Zertifikate zu generieren und Ihre Actual-Softwareinstallation zu sichern. Stellen Sie sicher, dass Sie den Domainnamen und die E-Mail-Adresse im folgenden Befehl ändern.

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email <[email protected]> -d budget.howtoforge.local

Wenn der Prozess abgeschlossen ist, sollte Ihre Actual-Installation mit HTTPS über Certbot und Letsencrypt gesichert sein. Ihre SSL-Zertifikate sind im Verzeichnis ‘ /etc/letsencrypt/live/domain.com ‘ verfügbar und HTTPS ist automatisch in Ihrer Serverblockdatei aktiviert.

Zugriff auf Actual Budget über den Webbrowser

Besuchen Sie den Domainnamen Ihrer Actual-Installation, z. B. https://budget.howtoforge.local. Wenn alles erfolgreich ist, sehen Sie die Willkommensnachricht von Actual und werden aufgefordert, ein Passwort einzurichten.

Geben Sie Ihr neues Passwort ein und wiederholen Sie es, und klicken Sie dann auf ‘ OK ‘.

Sobald das Passwort konfiguriert ist, geben Sie Ihr Passwort ein, um sich beim Actual Dashboard anzumelden.

Beim ersten Mal werden Sie gefragt, ob Sie Demo-Daten anzeigen oder neu starten möchten.

Wenn Sie mit Actual vertraut sind, können Sie auf ‘ Start fresh ‘ klicken, aber wenn Sie neu bei Actual sind, klicken Sie auf ‘ View demo ‘, um ein Gefühl für die grundlegende Nutzung von Actual zu bekommen.

Unten sehen Sie ein Beispiel für Demodaten aus dem Actual Budgeting System.

Fazit

Herzlichen Glückwunsch! Sie haben die Installation von Actual, einer datenschutzorientierten Finanzsoftware, auf einem Debian 12 Server abgeschlossen. Sie haben Actual als Systemd-Dienst im Hintergrund zum Laufen gebracht, der über den Nginx Reverse-Proxy läuft. Darüber hinaus haben Sie Actual auch mit HTTPS über Certbot und Letsencrypt gesichert.