3.2.1. コマンドラインからDolibarrとTalerbarrをインストールする#

重要: これは公式のDolibarrインストールチュートリアルでは**ありません**。DolibarrのUIやDolistoreからのインストールではなく、フォルダーベースのインストールを使用して、Talerbarrモジュールをインストールするための、エンドツーエンドの完全なガイドとしてのみ提供されています。

このチュートリアルは、開発者またはシステム管理者としての経験がある程度あるユーザーを対象としています。コマンドラインツールを使用したことがない場合は、Dolibarrチームが承認したSaaSソリューションなど、より使いやすい方法でDolibarrを入手することを検討してください。

3.2.1.1. Debianサーバーを持っている#

作業を進める前に、``sudo``アクセスを持つDebianサーバーが稼働していることを確認してください。このインストールでは、Dolibarrは一般ユーザーとして**rootless Podman**上で実行され、``sudo``はパッケージのインストールと初期システムセットアップにのみ使用されます。Rootless Podmanは公式にサポートされているモードであり、ログアウト後も存続し起動時に開始する必要があるユーザーサービスについては、Podman/systemdのガイダンスでそのユーザーに対してlingeringを有効にすることが推奨されています。

3.2.1.2. DNSレコードを用意する#

ドメインレジストラまたはDNSプロバイダーでDNSレコードを作成します：

タイプ: A

名前: erp、dolibarr、またはお好みの別のサブドメイン

値: サーバーのパブリックIPアドレス

3.2.1.3. Podmanをインストールする#

rootlessコンテナに必要なPodmanとツールをインストールします:

sudo apt update
sudo apt upgrade -y
sudo apt install -y podman podman-compose uidmap slirp4netns fuse-overlayfs passt aardvark-dns

3.2.1.4. Dolibarr専用ユーザーを作成する#

Dolibarrスタックを所有し実行する専用の非特権ユーザーを作成します:

sudo adduser --disabled-password --gecos "" dolibarr
sudo loginctl enable-linger dolibarr

``loginctl enable-linger``コマンドは重要です。これがないと、そのユーザーの最後のセッションが終了した後、ユーザーレベルのsystemdサービスが停止してしまうためです。

3.2.1.5. リバースプロキシを作成する#

お好みの方法で自由に設定していただいて構いません。正しい方法や間違った方法というものはほとんどありません。ここでは、このチュートリアルの文章と画像を完成させるために私たちが用意したシステムについて、参考として記載します。

ホストにNginxとCertbotをインストールします:

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

``/etc/nginx/sites-available/dolibarr.conf``を次の内容で作成し、``erp.example.com``を実際のドメインに置き換えてください:

server {
    listen 80;
    listen [::]:80;
    server_name erp.example.com;

    client_max_body_size 64M;

    location / {
        proxy_pass http://127.0.0.1:2793;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Port $server_port;
    }
}

サイトを有効化し、Nginxを再読み込みします:

sudo ln -s /etc/nginx/sites-available/dolibarr.conf /etc/nginx/sites-enabled/dolibarr.conf
sudo nginx -t
sudo systemctl reload nginx

Let's Encrypt証明書をリクエストします:

sudo certbot --nginx -d erp.example.com

証明書が正常に発行されると、CertbotはNginxの設定を更新してHTTPSを有効にし、HTTPトラフィックをHTTPSにリダイレクトします。

3.2.1.6. Dolibarrユーザーになる#

新しいユーザーに切り替えます:

sudo -iu dolibarr

このチュートリアルの残りのPodmanコマンドはすべて、デプロイメントをrootlessに保つため、このユーザーとして実行してください。

3.2.1.7. 永続ディレクトリを作成する#

永続データを保持するディレクトリを作成します:

mkdir -p ~/dolibarr/{mariadb,documents,custom}
cd ~/dolibarr

再起動時やDolibarrを新しいバージョンにアップグレードする際にデータを失わないよう、これらすべてを行う必要があります。

3.2.1.8. 環境ファイルを作成する#

Create a .env file for database and Dolibarr settings:

cat > .env <<'EOF'
MYSQL_ROOT_PASSWORD=CHANGE_THIS_ROOT_PASSWORD
MYSQL_DATABASE=dolidb
MYSQL_USER=dolidbuser
MYSQL_PASSWORD=CHANGE_THIS_DB_PASSWORD

DOLI_INSTALL_AUTO=1
DOLI_INIT_DEMO=0
DOLI_PROD=1
DOLI_DB_HOST=mariadb
DOLI_DB_HOST_PORT=3306
DOLI_DB_NAME=dolidb
DOLI_DB_USER=dolidbuser
DOLI_DB_PASSWORD=CHANGE_THIS_DB_PASSWORD
DOLI_URL_ROOT=https://erp.example.com
DOLI_ADMIN_LOGIN=admin
DOLI_ADMIN_PASSWORD=CHANGE_THIS_ADMIN_PASSWORD

WWW_USER_ID=1000
WWW_GROUP_ID=1000
EOF

これらの変数は、公式のDolibarrコンテナインターフェースの一部です。作業を進める前に、変更がないこと、また新しい制約や推奨事項が導入されていないことを必ず再確認してください。

3.2.1.9. composeファイルを作成する#

``compose.yml``を作成します:

cat > compose.yml <<'EOF'
services:
  mariadb:
    image: docker.io/library/mariadb:latest
    container_name: dolibarr-mariadb
    env_file:
      - .env
    volumes:
      - ./mariadb:/var/lib/mysql:Z
    restart: unless-stopped

  web:
    image: docker.io/dolibarr/dolibarr:latest
    container_name: dolibarr-web
    env_file:
      - .env
    depends_on:
      - mariadb
    ports:
      - "2793:80"
    volumes:
      - ./documents:/var/www/documents:Z
      - ./custom:/var/www/html/custom:Z
    restart: unless-stopped
EOF

3.2.1.10. Dolibarrを起動する#

スタックを起動します:

podman-compose up -d
podman-compose logs

コンテナが起動していることを確認します：

podman ps
podman-compose logs

ブラウザーを開き、次のURLに移動します:

https://erp.example.com

すべてが正しく設定されていれば、HTTPS経由でDolibarrのWebインターフェースが表示されるはずです。

3.2.1.11. カスタムモジュールをインストールする#

これで、``~/dolibarr/custom``ディレクトリにモジュールを配置できます。TalerBarrモジュールの例については、:ref:`talerbarr_install_from_source`に進んでください。

コマンドラインからDolibarrとTalerbarrをインストールする

目次