インストールガイド · 2 min read · Dec 09, 2025

FreeBSD 12にNginxを使用してInvoicePlaneをインストールする方法

InvoicePlaneは無料でオープンソースの請求書アプリケーションです。このチュートリアルでは、FreeBSD 12システムにInvoicePlaneをインストールする方法を示します。

要件

  • Webサーバー（Apache、NGINX）。このチュートリアルではNginxを使用します。
  • MySQLバージョン5.5以上または同等のMariaDBバージョン。
  • PHPバージョン7.0、7.1、または7.2で、以下のPHP拡張がインストールされ、アクティブになっていること：
    • php-gd
    • php-hash
    • php-json
    • php-mbstring
    • php-mcrypt
    • php-mysqli
    • php-openssl
    • php-recode
    • php-xmlrpc
    • php-zlib

前提条件

  • FreeBSD 12を実行しているサーバー。
  • sudo権限を持つ非rootユーザー。

初期ステップ

FreeBSDのバージョンを確認します：

uname -ro  
# FreeBSD 12.1-RELEASE

タイムゾーンを設定します：

tzsetup

オペレーティングシステムのパッケージ（ソフトウェア）を更新します。これは、オペレーティングシステムのデフォルトソフトウェアパッケージの最新の更新とセキュリティ修正を確保するための重要な最初のステップです：

freebsd-update fetch install  
pkg update && pkg upgrade -y

FreeBSD 12.0オペレーティングシステムの基本管理に必要な必須パッケージをいくつかインストールします：

pkg install -y sudo vim unzip wget bash

ステップ1 - PHPと必要なPHP拡張をインストール

InvoicePlaneウェブアプリケーションはPHPバージョン7.0以上を必要とします。

PHPと必要なPHP拡張をインストールします：

sudo pkg install -y php72 php72-ctype php72-curl php72-dom php72-hash php72-iconv php72-gd php72-json php72-mbstring php72-openssl php72-session php72-simplexml php72-xml php72-zip php72-zlib php72-pdo php72-pdo_mysql php72-mysqli php72-filter php72-ftp php72-tokenizer php72-calendar php72-pecl-APCu php72-opcache

PHPのバージョンを確認します：

php --version  
  
# PHP 7.2.7 (cli) (built: Jul 25 2019 01:28:53) ( NTS )  
# Copyright (c) 1997-2018 The PHP Group  
# Zend Engine v3.3.7, Copyright (c) 1998-2018 Zend Technologies  
# with Zend OPcache v7.3.7, Copyright (c) 1999-2018, by Zend Technologies

PHP-FPMサービスを有効にして開始します：

sudo sysrc php_fpm_enable=yes  
sudo service php-fpm start

ステップ2 - MySQLをインストール

MySQLデータベースサーバーをインストールします：

sudo pkg install -y mysql57-server

MySQLのバージョンを確認します：

mysql --version  
# mysql  Ver 14.14 Distrib 5.7.26, for FreeBSD12.0 (amd64) using  EditLine wrapper

MySQLサービスを有効にして開始します：

sudo sysrc mysql_enable="yes"  
sudo service mysql-server start

MySQLのセキュリティを向上させ、MySQL rootユーザーのパスワードを設定するためにmysql_secure_installationスクリプトを実行します：

sudo mysql_secure_installation

各質問に答えます：

Would you like to setup VALIDATE PASSWORD plugin? N  
New password: your_secure_password  
Re-enter new password: your_secure_password  
Remove anonymous users? [Y/n] Y  
Disallow root login remotely? [Y/n] Y  
Remove test database and access to it? [Y/n] Y  
Reload privilege tables now? [Y/n] Y

rootユーザーとしてMySQLシェルに接続します：

sudo mysql -u root -p  
# Enter password

Matomo用の空のMySQLデータベースとユーザーを作成し、資格情報を記録します：

CREATE DATABASE dbname;  
CREATE USER 'username'@'localhost' IDENTIFIED BY 'password';  
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';  
FLUSH PRIVILEGES;

MySQLから退出します：

exit

dbname、username、およびpasswordを自分の名前に置き換えます。

ステップ3 - acme.shクライアントをインストールし、Let’s Encrypt証明書を取得（オプション）

HTTPSでウェブサイトを保護することは必須ではありませんが、サイトのトラフィックを保護するための良いプラクティスです。Let’s EncryptからTLS証明書を取得するために、Acme.shクライアントを使用します。Acme.shは、依存関係ゼロでLet’s EncryptからTLS証明書を取得するための純粋なUNIXシェルソフトウェアです。 

Acme.shをダウンロードしてインストールします：

sudo pkg install -y acme.sh

Acme.shのバージョンを確認します：

acme.sh --version  
# v2.8.2

あなたのドメイン/ホスト名のためにRSAおよびECC/ECDSA証明書を取得します：

# RSA  
sudo acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048  
# ECDSA  
sudo acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256

上記のコマンドを実行した後、あなたの証明書と鍵は以下にあります：

  • RSAの場合：/etc/letsencrypt/example.comディレクトリ。
  • ECC/ECDSAの場合：/etc/letsencrypt/example.com_eccディレクトリ。

ステップ3 - NGINXをインストール

NGINXウェブサーバーをインストールします：

sudo pkg install -y nginx

NGINXのバージョンを確認します：

nginx -v  
# nginx version: nginx/1.14.2

NGINXサービスを開始し、有効にします：

sudo sysrc nginx_enable=yes  
sudo service nginx start

InvoicePlaneのためにNginxを設定するには、次のコマンドを実行します：

sudo vim /usr/local/etc/nginx/invoiceplane.conf

次の設定でファイルを埋めます：

server {
    listen 80;
    listen [::]:80;

    server_name example.com;

    root /usr/local/www/invoiceplane;

    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~* \.php$ {  
      fastcgi_pass 127.0.0.1:9000;  
      include fastcgi_params;  
      fastcgi_index index.php5;  
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
    }
}

NGINXの設定をテストします：

sudo nginx -t

NGINXを再読み込みします：

sudo service nginx restart

ステップ4 - InvoicePlaneをインストール

InvoicePlaneの最新の安定版をダウンロードし、アーカイブを抽出します：

sudo mkdir -p /usr/local/www  
cd /usr/local/www  
sudo curl -O -J -L https://invoiceplane.com/download/v1.5.9  
sudo unzip v1.5.9.zip  
sudo rm v1.5.9.zip  
sudo mv ip invoiceplane

/var/www/invoiceplaneディレクトリに移動します：

cd /usr/local/www/invoiceplane

ipconfig.php.exampleファイルのコピーを作成し、コピーの名前をipconfig.phpに変更します：

sudo cp ipconfig.php.example ipconfig.php

ipconfig.phpファイルを開き、そこにあなたのURLを追加します：

sudo vim ipconfig.php  
# こんな感じ  
IP_URL=http://example.com

/usr/local/www/invoiceplaneディレクトリの所有権をwww:に変更します：

sudo chown -R www:www /usr/local/www/invoiceplane

sudo vim /etc/php.iniを実行し、date.timezone:を設定します：

date.timezone = Region/City

PHP-FPMサービスを再起動します：

sudo service php-fpm restart

ウェブブラウザからInvoicePlaneインストーラーを実行し、指示に従います：

http://example.com/index.php/setup

インストールが完了したら、インストール中に選択したメールアドレスとパスワードを使用してInvoicePlaneにログインできます。

インストールを保護したい場合は、セットアップを無効にすることができます。そのためには、ipconfig.phpファイルのDISABLE_SETUP=false行をDISABLE_SETUP=trueに置き換えます。

ステップ5 - InvoicePlaneのセットアップを完了する

InvoicePlaneは現在インストールされ、設定されています。ウェブインストールウィザードにアクセスする時間です。

ウェブブラウザを開き、URL http://example.comを入力します。次のページにリダイレクトされます：

InvoicePlaneウェブインストーラー

次に、セットアップボタンをクリックします。次のページが表示されるはずです：

言語を選択

次に、言語を選択し、続行ボタンをクリックします。次のページが表示されるはずです：

システム要件を確認

次に、続行ボタンをクリックします。次のページが表示されるはずです：

データベースの詳細

ここで、データベースの詳細を提供し、再試行ボタンをクリックします。次のページが表示されるはずです：

データベース接続成功

次に、続行ボタンをクリックします。次のページが表示されるはずです：

ユーザーアカウントを作成

次に、続行ボタンをクリックします。次のページが表示されるはずです：

InvoicePlaneインストール完了

すべての必要な詳細を提供し、次に続行ボタンをクリックします。インストールが完了すると、次のページが表示されるはずです：

InvoicePlaneにログイン

次に、ログインボタンをクリックしてInvoicePlane管理にアクセスします。

リンク

Share: X/Twitter LinkedIn
#インストールガイド

新しい投稿を受信箱で受け取る

スパムはありません。いつでも購読を解除できます。