Debian 12サーバーにActual予算管理ソフトウェアをインストールする方法

Actual Budgetは、プライバシーに重点を置いたオープンソースの財務管理ソフトウェアで、「エンベロープスタイル予算」に基づいて構築されています。ActualはNode.jsで書かれており、すぐにローカルにインストールできます。マルチデバイス同期とオプションのエンドツーエンド暗号化をサポートしています。

このチュートリアルでは、Debian 12サーバーにActual予算管理システムをインストールする方法を示します。Nginxをリバースプロキシとして使用してActualをインストールし、CertbotとLetsencryptを通じてHTTPSで保護します。

前提条件

このチュートリアルを始める前に、以下を確認してください：

Debian 12サーバー
管理者権限を持つ非ルートユーザー
サーバーIPアドレスを指すドメイン名

Node.jsとYarnのインストール

Actualをインストールする前に、Node.js、Git、およびYarnパッケージマネージャーがシステムにインストールされていることを確認する必要があります。この時点で、ActualはNode v18以上を必要とし、公式のDebianリポジトリからインストールできます。

まず、以下の’apt‘コマンドを実行してDebianパッケージインデックスを更新し、Node.js、NPM、Gitなどの基本パッケージをインストールします。インストールを確認するには、’Y‘を入力します。

sudo apt update  
sudo apt install nodejs npm git

nodejsとnpmのインストール

インストールが完了したら、以下の’npm‘コマンドを使用してYarnパッケージマネージャーをインストールします。この例では、Yarnをグローバルまたはシステム全体にインストールします。

npm install --global yarn

完了したら、以下のコマンドでNode.jsとYarnのバージョンを確認します。

node --version  
yarn --version

以下の出力で、Node.js 18とYarn 1.22がインストールされていることが確認できます。

yarnの確認

Actual Budgetソースコードのダウンロード

依存関係がインストールされたら、Actualソースコードをダウンロードし、Yarnを介して依存関係をインストールし、’config.json’ファイルでActualを構成し、コマンドラインからActualを実行する準備が整いました。また、システムにActualをインストールして実行するための専用ユーザーが必要です。

以下のコマンドでユーザーにログインします。

su - username

以下の’git‘コマンドを使用してActual Budgetソースコードをダウンロードします。

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

actual-serverのダウンロード

‘actual-server‘ディレクトリに移動し、以下の’yarn‘コマンドを使用してJavaScriptの依存関係をインストールします。

cd actual-server  
yarn install

以下に、Yarnパッケージマネージャーを介してJavaScriptの依存関係がインストールされていることが示されています。

依存関係のインストール

インストールが完了したら、’nano‘エディタを使用して新しいファイル’config.json‘を作成します。

nano config.json

以下の構成を挿入して、デフォルトポート5006でローカルIPアドレスでActualを実行します。

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

ファイルを保存してエディタを終了します。

最後に、以下の’yarn start‘コマンドを実行してActualソフトウェアを起動します。これにより、アプリケーションが使用するローカルホストまたは’127.0.0.1‘アドレスでポート5006が開きます。

yarn start

プロセスを終了するには、Ctrl+cを押します。

yarn start

ActualをバックグラウンドでSystemdサービスとして実行

Actualをインストールして構成したので、ActualをバックグラウンドでSystemdサービスとして実行するための新しいsystemdサービスファイルを作成しましょう。

以下の’nano‘エディタを使用して新しいsystemdサービスファイル’ /etc/systemd/system/actual.service‘を作成します。

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

以下の構成を挿入して、ActualをバックグラウンドでSystemdサービスとして実行します。デフォルトの’User‘と’Group‘をあなたのユーザー名に変更し、’WorkingDirectory‘を適切なパスに変更してください。

[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

完了したら、ファイルを保存してエディタを終了します。

次に、以下の’systemctl‘コマンドを実行してsystemdマネージャーをリロードし、変更を適用します。

sudo systemctl daemon-reload

その後、以下のコマンドを使用して’actual.service‘を開始および有効にします。これにより、’actual.service‘がバックグラウンドで開始され、システム起動時に自動的に実行されるようになります。

sudo systemctl enable --now actual.service

サービスの有効化

以下のコマンドで’actual.service‘のステータスを確認します。’actual.service‘が実行中であり、システムで有効になっていることが確認できるはずです。

sudo systemctl status actual.service

actualサービスの確認

Nginxをリバースプロキシとして設定

この時点で、ActualはバックグラウンドでSystemdサービスとして実行されています。このセクションでは、Nginxをインストールし、Actualのリバースプロキシとして構成します。その後、CertbotとLetsencryptを介してActualデプロイメントのSSL証明書を生成します。

まず、以下の’apt‘コマンドを実行してNginx、Certbot、およびPython3 Certbot Nginxプラグインをインストールします。インストールを続行するには、’Y‘を入力します。

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

nginx certbotのインストール

インストールが完了したら、以下の’nano‘エディタを使用して新しいNginxサーバーブロックファイル’ /etc/nginx/sites-available/actual-budget‘を作成します。

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

以下の構成を挿入し、’server_name‘パラメータをあなたのドメイン名に変更してください。

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;  
}  
}

完了したら、ファイルを保存してエディタを終了します。

次に、以下のコマンドを実行して’actual-budget‘サーバーブロックを有効にし、Nginxの設定を確認します。エラーがなければ、’syntax is ok - test is successful‘のような出力が得られます。

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

nginxの設定

次に、以下のコマンドを実行してNginxサービスの状態を再起動および確認します。Nginxウェブサーバーが実行中であることを確認してください。

sudo systemctl restart nginx  
sudo systemctl status nginx

nginxの確認

最後に、以下の’certbot‘コマンドを実行してSSL証明書を生成し、Actualソフトウェアのインストールを保護します。以下のコマンドでドメイン名とメールアドレスを変更してください。

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

プロセスが完了すると、あなたのActualインストールはCertbotとLetsencryptを介してHTTPSで保護されるはずです。SSL証明書は’ /etc/letsencrypt/live/domain.com‘ディレクトリにあり、HTTPSはサーバーブロックファイルで自動的に有効になります。

ウェブブラウザを介してActual Budgetにアクセス

あなたのActualインストールのドメイン名（例： https://budget.howtoforge.local）にアクセスします。成功すると、Actualへの歓迎メッセージが表示され、パスワードの設定を求められます。

新しいパスワードを入力し、再度入力してから、’OK‘をクリックします。

パスワードの設定

パスワードが設定されると、Actualダッシュボードにログインするためにパスワードを入力します。

ログイン

初めての場合、デモデータを表示するか、新規スタートするかを尋ねられます。

Actualに慣れている場合は、’新規スタート‘をクリックできますが、Actualが初めての場合は、’デモを表示‘をクリックしてActualの基本的な使用法を把握してください。

データの表示

以下は、Actual Budgeting Systemからのデモデータの例です。

Actualダッシュボード

結論

おめでとうございます！Debian 12サーバーにプライバシーに重点を置いた財務ソフトウェアActualのインストールが完了しました。ActualはバックグラウンドでSystemdサービスとして実行されており、Nginxリバースプロキシの上で動作しています。さらに、CertbotとLetsencryptを通じてActualをHTTPSで保護しました。