カテゴリー: Firefly III

firefly-iiiのアップグレードを試みたところ、失敗。その記録と原因についてメモを残します。

環境

Ubuntu 24.04
Apache 2.4
MySQL 8.0.39
PHP 8.3.16
Composer 2.7.9
firefly-iii 6.1.5
→ 6.2.5にアップグレードを試みた

試した手順

DBのバックアップを取得します。
最新版のパッケージをダウンロードして展開します。
利用中のfirefly-iiiを待避させます。
待避させたfirefly-iiiからファイル/ディレクトリをコピーします。
アップグレードを行います。（失敗）

DBのバックアップ

作業ディレクトリに移動

cd /hoge && pwd

任意の作業ディレクトリに移動します。

DBバックアップ

mysqldump --no-tablespaces --single-transaction -u username -h localhost -p database_name > DB_Backup.$(date +%Y%m%d).sql

usename、database_name、及びDB_Backupは自分の環境に合わせます。

バックアップ確認

head -100 DB_Backup.$(date +%Y%m%d).sql

バックアップができていること、平文でSQLが読めることを確認します。

パッケージ取得

作業ディレクトリに移動

cd /hoge && pwd

任意の作業ディレクトリに移動します。

wget

wget https://github.com/firefly-iii/firefly-iii/releases/download/v6.2.5/FireflyIII-v6.2.5.zip

ファイル所有者変更

sudo chown www-data:www-data FireflyIII-v6.2.5.zip

ファイル確認

ls -l FireflyIII-v6.2.5.zip

ファイルがあること、所有者がWebアプリ実行ユーザ(www-data)であることを確認します。

アップデート前のfirefly-iiiを待避

ディレクトリごと待避

sudo mv /home/www-data/firefly-iii /home/www-data/firefly-iii.$(date +%Y%m%d)

自分の環境に合わせます。firefly-iiiがインストールされているディレクトリをまるごと移動します。

待避確認

ls -ld /home/www-data/firefly-iii

→ ディレクトリが無いこと

ls -ld /home/www-data/firefly-iii.$(date +%Y%m%d)

→ ディレクトリがあること

アップデートパッケージの解凍と配置

解凍

sudo -u www-data unzip -o /hoge/FireflyIII-v6.2.5.zip -x "storage/*" -d /home/www-data/firefly-iii

/hogeは先ほど取得したパッケージがある場所です。アップデート前と同じ位置、名前に解凍します。

解凍・配置確認

ls -l /home/www-data/firefly-iii

ファイル一式があり、www-dataが所有者になっていること

アップデート前のファイル・ディレクトリをコピー

待避させたディレクトリに移動

cd /home/www-data/firefly-iii.$(date +%Y%m%d) && pwd

自分の環境に合わせます。

.envファイルをコピー

sudo -u www-data cp -pi .env /home/www-data/firefly-iii/.env

コピー先のディレクトリは自分の環境に合わせます。

.envファイルコピー確認

ls -l /home/www-data/firefly-iii/.env

ファイルがあることを確認します。

storageディレクトリのコピー

sudo -u www-data cp -pir storage /home/www-data/firefly-iii/

storageディレクトリのコピー確認

ls -l /home/www-data/firefly-iii/storage

ファイルやディレクトリがあることを確認します。

アップグレード → 失敗

アップグレード後のディレクトリに移動

cd /home/www-data/firefly-iii && pwd

先ほど展開したディレクトリに移動します。

DBマイグレーション

sudo -u www-data php artisan migrate --seed

ここで失敗。以下のエラーが出ました。

Composer detected issues in your platform:

Your Composer dependencies require a PHP version ">= 8.4.0". You are running 8.3.16.

PHP Fatal error: Composer detected issues in your platform: Your Composer dependencies require a PHP version ">= 8.4.0". You are running 8.3.16. in /home/www-data/firefly-iii/vendor/composer/platform_check.php on line 22

そのため、切り戻しを行います。

失敗したため切り戻し

Webコンテンツ配置ディレクトリに移動

cd /home/www-data && pwd

自分の環境に合わせます。

展開したディレクトリ削除

sudo rm -rf /home/www-data/firefly-iii

ディレクトリ退避から復旧

sudo mv /home/www-data/firefly-iii.$(date +%Y%m%d) /home/www-data/firefly-iii

ディレクトリ復旧確認

ls -l /home/www-data/firefly-iii

ファイル一式があり、www-dataが所有者になっていること

切り戻し反映・確認

Webサービス再起動

sudo systemctl restart apache2.service

Webサービス再起動確認

systemctl status apache2.service

霧もろし確認

アップデートを行ったfirefly-iiiサイトにブラウザでアクセスします。
ログインできることを確認します。
バージョンが上がっていることを確認します。
登録操作などができることを確認します。

失敗の要因

これは明白にして単純です。

リリースノートを確認していなかった

に尽きます。LAMP環境で動くからこそ、ミドルウェアのバージョン(この場合はPHP)の必要とするバージョンを確認していなかった自分の落ち度です。

v6.2.0のリリースノートに

Firefly III requires PHP 8.4.

と書かれていることを見落としていました。

切り戻しが迅速だった要因

「切り戻しを前提としていた手順」に助けられました。

作業前にDBのバックアップ
動いていた環境を退避

させる二段構えにより、迅速な切り戻しが可能になりました。

結局のところ、

「自分の確認不足」から来るミスを「自分の確認不足を想定した手順」でカバーした形です。

Firefly-III 1年間の検証結果と運用レビュー

By manualmaton

オン 2024年12月28日

カテゴリー: Firefly III, Linux

オープンソースの家計管理システム「Firefly-III」を使い始めてから1年が経過しました。この1年間の運用を通じて、得られた知見や感想をまとめました。最初に導入した環境や特徴的なポイントについて、振り返ってみます。

環境の構築

最初にインストールした環境は、Ubuntu 20.04にPHP 8.1を使用していましたが、その後、Ubuntu 24.04とPHP 8.3にアップグレードしました。

(インストールのメモはこちら)

構築自体はWordpressの構築実績があれば理解可能で、公式ドキュメントに従うことでスムーズに進みました。特に専門的な知識がなくても、簡単に運用を開始できる点は大きな魅力でした。

入力の簡便さ

家計簿の管理で最も重要なのは、入力の手間をいかに減らすかです。Firefly-IIIでは、サブスクリプションや保険料など、毎月定期的に発生する費用を簡単にコピーして入力できる機能があり、手間を大幅に削減できました。これにより、月ごとの出金管理が非常に楽になりました。

直感的なインターフェース

「Firefly-III」のインターフェースは非常に直感的で、出金、入金、送金というシンプルな3つの取引項目で構成されています。このシンプルさにより、簿記などの知識に乏しくても迷うことなく運用できるようになりました。

視覚的な管理: グラフの活用

「Firefly-III」では、家計の動きをグラフで視覚化できるため、特に大きな支出がある場合に、どのくらいの金額が減るのかが一目で分かります。また、クレジットカードのような未来の引き落としもグラフに表示されるため、前もって支出を把握することができます。

予算管理とモチベーションの向上

予算を設定することで、趣味や娯楽に使うお金の限度を決めることができ、(ある程度の)無駄遣いを防げました。デジタルガジェットの購入やフィギュアの予約などに備えて出費を抑えられるようにもなりました。

また、「Firefly-III」では予算管理以外にもカテゴリー分けができ、食費や日用品などを細かく把握することができました。これにより、家計全体のバランスをよりよく理解できるようになりました。

入出金は極めて有用なライフログ

家計簿をつけることで、いつ、どこで、何に、どれくらい使ったかという行動の記録が残ります。この記録は、単なる金銭的な管理にとどまらず、ライフログとしても非常に有用です。例えば、病院での支出を記録することで、いつ、どの病気にかかったかがわかり、過去の体調管理にも役立ちました。

また、突発的な出来事の際に、どのような出金が発生したかも目の当たりにできました。

旅行時の支出記録

旅行中も「Firefly-III」は大いに役立ちました。どんな店で何を食べたのか、お土産を買ったのかなど、旅行の詳細を記録しておくことで、後から振り返って思い出に浸ることができました。

すべての支出を記録するのは大変

一方で、全ての支出を記録するのはやはり大変です。LINEなどのトークアプリで自分自身にメモを送ることで忘れずに記録していますが、入力ミスや記録漏れが発生することもあり、後で差分をチェックすることが課題として残っています。

とはいえ、自分自身の予算管理のために多少の誤差は許容できる範囲であり、精度向上のための改善は引き続き行っています。

運用に関する課題

「Firefly-III」をサーバーで管理するため、サーバー運用に関する一定の知識が必要です。また、お金の流れという非常にセンシティブな情報を扱うため、慎重な運用が求められます。

データのセキュリティやバックアップについても配慮が必要です。

今後の目標

今後は、「Firefly-III」のタグ機能を活用して、さらに細かく支出のカテゴリーを分けて管理していく予定です。

また、自動的に支出が登録される仕組み（例えばAPIやスマートフォンアプリを活用）を導入することで、手間をさらに減らすことを目指しています。最終的には、資産の流れをより明確に把握し、効果的な予算の策定を行いたいと考えています。

1年間の運用を通じて、Firefly-IIIは家計管理を効率的に行うための強力なツールであることが実感できました。今後も継続して使いながら、より精度の高い予算管理を目指していきたいと思います。

Firefly-iiiのアップデート。(6.1.2→6.2.1)

By manualmaton

オン 2024年10月18日

カテゴリー: Firefly III, Linux

LAMP環境で動く財務管理システム、firefly-iiiを6.1.2→6.2.1にアップグレードしたときの手順メモです。

参考:Upgrade a self-managed server/Firefly III documentation

環境

Ubuntu 24.04
Apache 2.4
MySQL 8.0.39
PHP 8.3.12
Composer 2.7.9
firefly-iii 6.1.2

さっくりとした手順

DBのバックアップを取得します。
最新版のパッケージをダウンロードして展開します。
利用中のfirefly-iiiを待避させます。
待避させたfirefly-iiiからファイル/ディレクトリをコピーします。
アップグレードを行います。

DBのバックアップ

作業ディレクトリに移動

cd /hoge && pwd

任意の作業ディレクトリに移動します。

DBバックアップ

mysqldump --no-tablespaces --single-transaction -u username -h localhost -p database_name > DB_Backup.$(date +%Y%m%d).sql

usename、database_name、及びDB_Backupは自分の環境に合わせます。

バックアップ確認

head -100 DB_Backup.$(date +%Y%m%d).sql

バックアップができていること、平文でSQLが読めることを確認します。

パッケージ取得

作業ディレクトリに移動

cd /hoge && pwd

任意の作業ディレクトリに移動します。

wget

wget https://github.com/firefly-iii/firefly-iii/releases/download/v6.1.21/FireflyIII-v6.1.21.zip

ファイル所有者変更

sudo chown www-data:www-data FireflyIII-v6.1.21.zip

ファイル確認

ls -l FireflyIII-v6.1.21.zip

ファイルがあること、所有者がWebアプリ実行ユーザ(www-data)であることを確認します。

アップデート前のfirefly-iiiを待避

ディレクトリごと待避

sudo mv /home/www-data/firefly-iii /home/www-data/firefly-iii.$(date +%Y%m%d)

自分の環境に合わせます。firefly-iiiがインストールされているディレクトリをまるごと移動します。

待避確認

ls -ld /home/www-data/firefly-iii

→ ディレクトリが無いこと

ls -ld /home/www-data/firefly-iii.$(date +%Y%m%d)

→ ディレクトリがあること

アップデートパッケージの解凍と配置

解凍

sudo -u www-data unzip -o /hoge/FireflyIII-v6.1.21.zip -x "storage/*" -d /home/www-data/firefly-iii

/hogeは先ほど取得したパッケージがある場所です。アップデート前と同じ位置、名前に解凍します。

解凍・配置確認

ls -l /home/www-data/firefly-iii

ファイル一式があり、www-dataが所有者になっていること

アップデート前のファイル・ディレクトリをコピー

待避させたディレクトリに移動

cd /home/www-data/firefly-iii.$(date +%Y%m%d) && pwd

自分の環境に合わせます。

.envファイルをコピー

sudo cp -pi .env /home/www-data/firefly-iii/.env

コピー先のディレクトリは自分の環境に合わせます。

.envファイルコピー確認

ls -l /home/www-data/firefly-iii/.env

ファイルがあることを確認します。

storageディレクトリのコピー

sudo cp -pir storage /home/www-data/firefly-iii/

storageディレクトリのコピー確認

ls -l /home/www-data/firefly-iii/storage

ファイルやディレクトリがあることを確認します。

アップグレード

アップグレード後のディレクトリに移動

cd /home/www-data/firefly-iii && pwd

先ほど展開したディレクトリに移動します。

DBマイグレーション

sudo -u www-data php artisan migrate --seed

Yesが見えるようにして実行します。

一時複合化

sudo -u www-data php artisan firefly-iii:decrypt-all

アプリケーションキャッシュクリア

sudo -u www-data php artisan cache:clear

コンパイルされたビューのキャッシュクリア

sudo -u www-data php artisan view:clear

DBアップグレード

sudo -u www-data php artisan firefly-iii:upgrade-database

Laravel assportのキー生成

sudo -u www-data php artisan firefly-iii:laravel-passport-keys

アップグレード反映・確認

Webサービス再起動

sudo systemctl restart apache2.service

Webサービス再起動確認

systemctl status apache2.service

アップデート確認

アップデートを行ったfirefly-iiiサイトにブラウザでアクセスします。
ログインできることを確認します。
バージョンが上がっていることを確認します。
登録操作などができることを確認します。

アップデート後の処理:mysqldumpの削除

バックアップしたDBの削除

cd /hoge && pwd

mysqldumpを実行したディレクトリに移動します。

dump削除

rm DB_Backup.$(date +%Y%m%d).sql

バックアップ削除確認

head -100 DB_Backup.$(date +%Y%m%d).sql

ファイルが読めないことを確認します。

アップデート後の処理待避させたディレクトリの削除

削除前：待避ディレクトリ確認

ls -ld /home/www-data/firefly-iii.$(date +%Y%m%d)

ディレクトリがあることを確認します。（自分の環境に合わせます。）

待避させたディレクトリの削除

[ -d "/home/www-data/firefly-iii.$(date +%Y%m%d)" ] && sudo rm -rf "/home/www-data/firefly-iii.$(date +%Y%m%d)"

それぞれ、待避させたディレクトリであることを入念に確認してから行ってください。

削除前：待避ディレクトリ確認

ls -l /home/www-data/firefly-iii.$(date +%Y%m%d)

ディレクトリがないことを確認します。

Ubuntu 20.04で動いていたfirefly-iiiをUbuntu24.04にデータ移行。

By manualmaton

オン 2024年9月13日

カテゴリー: Firefly III, Linux

Linuxで動く財務管理システムfirefly-iii。

Ubuntu 24.04で動くことを確認したので、20.04からのデータを移行しました。（自分の手順では）

環境

移行前

Ubuntu 20.04
PHP 8.1
firefly-iii 5.7.9

移行先

Ubuntu 20.04
PHP 8.3
firefly-iii 6.1.16

その他はApache、MySQL環境です。

さっくりとした(?)手順

移行先のfirefly-iiiを構築します。
移行前のSQLダンプファイルを取得します。
移行先でダンプファイルをインポートします。
動作を確認します。

【移行先】firefly-iiiを構築します。

方法はこちらです。

【移行元】DBのダンプファイルを取得します。

ディレクトリ移動

cd /hoge && pwd

任意のディレクトリを指定します。

ダンプファイル取得

mysqldump -u firelfy -p --no-tablespaces --single-transaction firefly > firefly_$(date +%Y%m%d).sql

-u DBユーザー >の左のfireflyはDB名です。自分の環境に合わせます。

パスワードを入力してもファイルが取得できないときは？

パスワードに!などの特殊文字が入っていると羽の肥えるパターンがあります。passwdといったファイルを作成し、以下のように記入します。

[mysqldump]
user=DBユーザー
password=''

※パスワードはシングルクォーテーションで囲みます。

こちらのファイルを作った上で、

mysqldump --defaults-extra-file=passwd --no-tablespaces --single-transaction firefly > firefly_$(date +%Y%m%d).sql

実行します。 このpasswdファイルは作業後に削除します。

ファイル取得確認

head -50 firefly_$(date +%Y%m%d).sql

ダンプファイルの内容が見られることを確認します。

このダンプファイルを任意の安全な方法で移行先にコピーします。

【移行先】DBのインポートを行います。

ディレクトリ移動

cd /hoge && pwd

ダンプファイルを転送したディレクトリを指定します。

DBインポート

mysql -h localhost -u firefly -p firefly < firefly_$(date +%Y%m%d).sql

ユーザ名やDB名は自分の環境に合わせます。

Webサービス(Apache)再起動

sudo systemctl restart apache2.service

サービス再起動確認

systemctl status apache2.service

active(running)を確認します。

動作の確認を行います。

移行先のfirefly-iiiをインストールしたドメインにアクセスして

移行元のアカウントで認証できること
移行元のデータが確認できること
データの検索や登録ができること

を確認できればOKです。

作業の後処理を行います。

ディレクトリ移動

cd /hoge && pwd

ダンプファイルを転送したディレクトリを指定します。

ダンプファイル削除

sudo rm firefly_$(date +%Y%m%d).sql

必要に応じて、移行元サイトの閉鎖を行います。

Ubuntu24.04にfirefly-iiiをインストール。(php8.3対応版)

By manualmaton

オン 2024年9月10日

カテゴリー: Firefly III, Linux

検証:firefly-iii v6.1.0をUbuntu 20.04にインストール（失敗）

ここから施行を繰り返し、「結局、Ubuntu24.04でなければ動かないだろう」という結論。

無事にインストールできたので、その記録です。

環境

以下、既に構築済みという状況です。

Ubuntu 24.04
Apache 2.4
MySQL 8.3
PHP 8.3
Composer 2.8.6
- インストール方法

そして、以下を準備済みです。

サイトにアクセスするドメインとDNS登録
上記に沿った適切な証明書

さっくりとした手順

プログラムをダウンロードします。
composerでインストールします。
DBを作成します。
.envを設定します。
DBのマイグレーションを行います。
ログファイルの格納ディレクトリを設定します。
ApacheでWebサーバの設定を行います。
アクセスを確認します。

Firefly III のダウンロード

ディレクトリ移動

cd /home/www-data

Web公開用のディレクトリを指定します。

プログラムのダウンロード

git clone https://github.com/firefly-iii/firefly-iii.git -b v6.1.19

※PHP8.3で稼働するバージョンを指定しています。

ダウンロード確認

ls -ld firefly-iii

ディレクトリが作成されていること、Web実行ユーザ(www-data)であることを確認します。

DB作成

mysqlログイン

mysql -u root -p

DB作成

CREATE DATABASE firefly character set utf8mb4;

CREATE USER 'firefly'@'localhost' IDENTIFIED BY 'password';

GRANT ALL PRIVILEGES ON firefly.* TO 'firefly'@'localhost';

FLUSH PRIVILEGES;

EXIT;

ポリシーに合わせて強固なパスワードを指定します。

.env設定

.envのサンプルをコピー

sudo cp -pi .env.example .env

ファイル修正
- .env を教義・信仰に沿ったエディタで修正します。

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=firefly
DB_USERNAME=firefly
DB_PASSWORD=your_password

最低限、上記を指定します。パスワードはDB作成時のものです。

DBマイグレーション

sudo -u www-data php artisan firefly-iii:upgrade-database

sudo -u www-data php artisan firefly-iii:correct-database

sudo -u www-data php artisan firefly-iii:report-integrity

sudo -u www-data php artisan passport:install

ログファイルの格納ディレクトリを作成

ディレクトリ作成

sudo mkdir /var/log/firefly

ディレクトリの所有者変更

sudo chown -R www-data www-data /var/log/firefly

ディレクトリ作成確認

ls -ld /var/log/firefly

Apache設定

以下のファイルを作成します。
/etc/apache2/sites-available/firefly-iii.conf
【】の箇所は、自分の環境に合わせて修正してください。

cat <<- __EOF__ | sudo tee -a /etc/apache2/sites-available/firefly-iii.conf
<VirtualHost *:80>
    servername 【bank.example.com】
    # ドメイン名を指定します
    RewriteEngine On
        RewriteCond %{HTTPS} off
        RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
# HTTPアクセスを強制的にHTTPSにリダイレクトします
</VirtualHost>

<VirtualHost *:443>
    ServerName 【bank.example.com】
    # ドメイン名を指定します
    CustomLog 【/var/log/firefly/firefly_access.log】 combined
    ErrorLog 【/var/log/firefly/firefly_error.log】
    DocumentRoot 【/home/www-data/firefly-iii/public】
    # 自身の環境に合わせます
    <Directory 【/home/www-data/firefly-iii/public】>
    # 自身の環境に合わせます
        AllowOverride All
        Require all granted
    </Directory>

#SSL設定
  SSLEngine on
    Protocols h2 http/1.1
  # SSLを有効化します

SSLCertificateFile 【/etc/certs/bank.example.com.crt】
# SSL証明書を指定します
SSLCertificateKeyFile 【/etc/private/bank.example.com.key】
# 秘密鍵を指定します

# SSLCACertificateFile 【/etc/certs/bank.example.com.crt】
# 中間証明書が発行元から別ファイルで提供されている場合は、この直上をコメントアウトして中間証明書を指定します

#セキュリティヘッダー付与

    Header always set Strict-Transport-Security "max-age=63072000"
    Header set X-Content-Type-Options "nosniff"
    Header always append X-Frame-Options "SAMEORIGIN"
    Header set X-XSS-Protection "1; mode=block"

</VirtualHost>

SSLProtocol             all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLCipherSuite          ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:EC6-GCM-SHA384
SSLHonorCipherOrder     off
SSLSessionTickets       off

SSLUseStapling On
SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"
__EOF__

設定反映

設定反映

sudo a2ensite firefly-iii.conf

Webサービス再起動

sudo systemctl restart apache2

インストール確認

設定したURLにアクセスします。（ここではbank.example.com)

Email address
パスワード（16文字以上）

を設定して、「Register」をクリックします。

続いて初期設定(メインバンクや通貨、言語の指定など)完了後、ダッシュボードが出てくればインストール完了です。

2023年の主な出来事-サーバ編-

By manualmaton

オン 2023年12月29日

カテゴリー: BookStack, Firefly III, Linux, nextcloud, PC, redmine

概要

2023年もじきに終わるということで、今年のまとめ。趣味のサーバ運用という点では大きなものがいくつかありました。

新たにインターネット上に構築したサイト

公開用Redmine作成

https://atelier.reisalin.com/

これが一番大きいです。

推しの名前でドメインが取得できたことにより、「これでWebを公開しよう」と思い立ち、正月休みから行動スタート。

ゲーム『ライザのアトリエ3』リリースに間に合わせ、様々な攻略情報を載せることができました。

Redmine自身の各種情報も掲載できたのも満足です。

アクセス解析システム：matomo作成

非公開

公開用サイトのアクセス状況を知りたくて、このシステムをインストール。

Redmineとの連携はView_Customize_Pluginでなんとかなりましたし、その際、本邦のRedmineメンテナ様自身直々のアドバイスをいただけたことが印象に残っています。

フォトアルバムサイト：piwigo作成

https://hideout.reisalin.com

フォトアルバムもついでに作成。

写真の拡充を図っていくのが来年度の目標になりそうです。

ドキュメント保存システム：BookStack作成

https://barrel.reisalin.com

Redmineのプラグイン「knowlegebase」に代わるシステムを探していたら見つけました。

本棚や本という概念
Markdownフレンドリー
見出しに合わせたスクロール

など、おおよその欲しかった機能が備わっていて、今後のメインウェポンとなる予感です。

ローカルに構築したサイト

Nextcloud

2022年から継続利用。

Growi

2022年から利用しているマークダウンエディタ、growi。

2023年はmermaid.jsにようやく対応したので、デジタルでのメモ残しに大きく貢献しました。

firefly-iii

つい先日ではありますが、この財務管理システムを知ったおかげで「お金関係のロギング」を始められるようになりました。

来年度の目標

Ubuntu 20.04リプレース。

LTSのEOL2025年に備えます。そのためのボトルネックとなっている

Redmineのメジャーバージョンアップ
およびknoledgebaseの代替システム（現状候補はBookStack）

と検証を進めます。

サーバのスペックアップ

これに関しては予算と相談しながら。

検証:firefly-iii v6.1.0をUbuntu 20.04にインストール（失敗）

By manualmaton

オン 2023年12月24日

カテゴリー: Firefly III, Linux

概要

PHPもDBも入っていない検証機があったので、Firefly iii 6系を入れようとしましたが、失敗しました。

以下は失敗の記録です。

環境

Ubuntu 20.04
Nginx

結論

php8.3-bcmatchがインストールできないことによるComposerエラーです。

やってみた手順

1.Postgresqlのインストール
1.PostgresのDB作成
1.PHPのインストール
1.composerのインストール
1.firefly iiiの配置
1.Composerによるインストール

PostgreSQLのインストール

パッケージアップデート

sudo aptitude update

PostgreSQLインストール

sudo aptitude install postgresql postgresql-contrib

PostgreSQLの軌道確認

 systemctl status postgresql.service

Active: active (exited) を確認します

PostgreSQLのDB作成

コンソールログイン

sudo -u postgres psql

DBとユーザ作成

CREATE DATABASE firefly;
CREATE USER firefly_user WITH PASSWORD 'your_password';
ALTER ROLE firefly_user SET client_encoding TO 'utf8';
ALTER ROLE firefly_user SET timezone TO 'Asia/Tokyo';
GRANT ALL PRIVILEGES ON DATABASE firefly TO firefly_user;
quit

パスワードはポリシーに沿って適切なものを指定します

PHP8.3インストール

リポジトリ追加

sudo aptitude install software-properties-common

sudo curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg

sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'

パッケージアップデート

sudo aptitude update

PHP8.3インストール

sudo aptitude install php8.3 php8.3-cli php8.3-fpm php8.3-pgsql php8.3-xml php8.3-mbstring php8.3-gd

バージョン確認

php -v

8.3系であることを確認します。

Composerインストール

cd /hoge
# 任意の作業ディレクトリに移動します
sudo php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
sudo php composer-setup.php
sudo mv composer.phar /usr/bin/composer

パス確認

which composer

/usr/bin/composerにあることを確認します

バージョン確認

composer --version

2023/12/23現在、2.6.6でした

プログラム配置

ディレクトリ移動

cd /var/www/html/ && pwd

任意の公開用ディレクトリを指定します

gitでファイル取得

sudo -u www-data git clone https://github.com/firefly-iii/firefly-iii.git

ディレクトリ移動

cd firefly-iii && pwd

※失敗：Composerでインストール※

sudo -u www-data composer install --no-dev --prefer-dist

以下のエラーが出て来ました。

Installing dependencies from lock file
Verifying lock file contents can be installed on current platform.
Your lock file does not contain a compatible set of packages. Please run composer update.

  Problem 1
    - Root composer.json requires PHP extension ext-bcmath * but it is missing from your system. Install or enable PHP's bcmath extension.

sudo apittude install php8.3-bcmatch

としてもプログラムは見つからず。

まずは記録として遺しておきます。

今後の展望

Ubuntuそのもののバージョンアップを見据えて動きます。

Firefly III とGmail連携

By manualmaton

オン 2023年12月23日

カテゴリー: Firefly III, Linux

概要

インストールが完了したFirefly iiiと、Gmailを連携させていきます。

基本的にRedmineのGmail連携と同じ手順でした。

前提

https://atelier.reisalin.com/projects/zettel/knowledgebase/articles/22

に従って、アプリパスワードを設定していることが条件です。

※Googleアカウントにフルアクセス可能なパスワードのため、取り扱いは注意してください。※

手順

ディレクトリ移動

cd /home/www-data/firefly-iii &&pwd

自分がインストールしたディレクトリを指定します。

ファイル編集

.env

以下の箇所を変更して保存します。

MAIL_MAILER=smtp
MAIL_HOST=[googleから指定されたメールアドレス]
MAIL_PORT=587
MAIL_FROM=[Gmailアドレス]
MAIL_USERNAME=[Gmailアドレス]
MAIL_PASSWORD=[アプリパスワード]
MAIL_ENCRYPTION=true

設定反映

sudo systemctl restart apache2.service

自分がインストールしているWebサービスを利用します

設定確認

firefly-iiiのサイトにアクセスします。
ログインします。
管理＞メッセージを送信をクリックします。
メールが送信されていれば設定完了です。

Firefly III をローカルサーバにインストール。(PHP8.1対応版)

By manualmaton

オン 2023年12月22日

カテゴリー: Firefly III, Linux, PC

概要

家計簿的なシステムをオープンソースで作れないものかと思っていたところ、

https://www.firefly-iii.org/

というシステムを発見しました。

無事に動かすことができたので、メモを残します。

インストールの前に

このシステムは、ローカル環境で利用することを強くお勧めします。(金融情報を記録するため)

環境

以下、既に構築済みという状況です。

Ubuntu 20.04
Apache 2.4
MySQL 8.3
PHP 8.1
Composer 2.6.5

そして、以下を準備済みです。

サイトにアクセスするドメインとDNS登録
上記に沿った適切な証明書

さっくりとした手順

プログラムをダウンロードします。
composerでインストールします。
DBを作成します。
.envを設定します。
DBのマイグレーションを行います。
ログファイルの格納ディレクトリを設定します。
ApacheでWebサーバの設定を行います。
アクセスを確認します。

Firefly III のダウンロード

ディレクトリ移動

cd /home/www-data

Web公開用のディレクトリを指定します。

プログラムのダウンロード

sudo -u www-data git clone https://github.com/firefly-iii/firefly-iii.git -b 5.7.9

※PHP8.1で稼働するバージョンを指定しています。

ダウンロード確認

ls -ld firefly-iii

ディレクトリが作成されていること、Web実行ユーザ(www-data)であることを確認します。

Firefly III のインストール

ディレクトリ移動

cd firefly-iii && pwd

Composerでインストール

sudo -u www-data composer install --no-dev --prefer-dist

エラーがないことを確認します。

DB作成

mysqlログイン

mysql -u root -p

DB作成

CREATE DATABASE firefly;
CREATE USER 'firefly'@'localhost' IDENTIFIED BY 'パスワード';
GRANT ALL PRIVILEGES ON firefly.* TO 'firefly'@'localhost';
FLUSH PRIVILEGES;
EXIT;

ポリシーに合わせて強固なパスワードを指定します。

.env設定

.envのサンプルをコピー

sudo cp -pi .env.example .env

ファイル修正
- .env

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=firefly
DB_USERNAME=firefly
DB_PASSWORD=your_password

最低限、上記を指定します。パスワードはDB作成時のものです。

DBマイグレーション

sudo -u www-data php artisan firefly-iii:upgrade-database

sudo -u www-data php artisan firefly-iii:correct-database

sudo -u www-data php artisan firefly-iii:report-integrity

sudo -u www-data php artisan passport:install

ログファイルの格納ディレクトリを作成

ディレクトリ作成

sudo mkdir /var/log/firefly

ディレクトリの所有者変更

sudo chown -R www-data www-data /var/log/firefly

ディレクトリ作成確認

ls -ld /var/log/firefly

Apache設定

以下のファイルを作成します。
/etc/apache2/sites-available/firefly-iii.conf

※ドメイン名や証明書の格納場所は自分の環境に合わせてください。

<VirtualHost *:80>
    servername bank.example.com
    # ドメイン名を指定します
    RewriteEngine On
        RewriteCond %{HTTPS} off
        RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
# HTTPアクセスを強制的にHTTPSにリダイレクトします
</VirtualHost>

<VirtualHost *:443>
    ServerName bank.example.com
    # ドメイン名を指定します
    CustomLog /var/log/firefly/firefly_access.log combined
    ErrorLog /var/log/firefly/firefly_error.log
    DocumentRoot /home/www-data/firefly-iii/public
    # 自身の環境に合わせます
    <Directory /home/www-data/firefly-iii/public>
    # 自身の環境に合わせます
        AllowOverride All
        Require all granted
    </Directory>

#SSL設定
  SSLEngine on
    Protocols h2 http/1.1
  # SSLを有効化します

SSLCertificateFile /etc/certs/bank.example.com.crt
# SSL証明書を指定します
SSLCertificateKeyFile /etc/private/bank.example.com.key
# 秘密鍵を指定します

# SSLCACertificateFile /etc/certs/bank.example.com.crt
# 中間証明書が発行元から別ファイルで提供されている場合は、この直上をコメントアウトして中間証明書を指定します

#セキュリティヘッダー付与

    Header always set Strict-Transport-Security "max-age=63072000"
    Header set X-Content-Type-Options "nosniff"
    Header always append X-Frame-Options "SAMEORIGIN"
    Header set X-XSS-Protection "1; mode=block"

</VirtualHost>

SSLProtocol             all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLCipherSuite          ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:EC6-GCM-SHA384
SSLHonorCipherOrder     off
SSLSessionTickets       off

SSLUseStapling On
SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"

設定反映

設定反映

sudo a2ensite firefly-iii.conf

Webサービス再起動

sudo systemctl restart apache2

インストール確認

設定したURLにアクセスします。（ここではbank.example.com)

Email address
パスワード（16文字以上）

を設定して、「Register」をクリックします。

続いて初期設定(メインバンクや通貨、言語の指定など)完了後、こちらのダッシュボードが出てくればインストール完了です。

使い勝手やカスタマイズは改めて報告します。

2025年2月
月	火	水	木	金	土	日
					1	2
3	4	5	6	7	8	9
10	11	12	13	14	15	16
17	18	19	20	21	22	23
24	25	26	27	28