ERPNext 完全ガイド 2026：オープンソース ERP のインストール、設定、カスタム開発実践

# 1. Docker と Docker Compose をインストール
curl -fsSL https://get.docker.com | sh
sudo systemctl enable --now docker

# 2. Docker Compose をインストール（標準で付いていない場合）
sudo apt install docker-compose-plugin

# 3. 公式 docker-compose 設定をクローン
git clone https://github.com/frappe/frappe_docker.git
cd frappe_docker

# 4. 環境変数ファイルを作成
cp example.env .env

# .env ファイルを編集し、以下の主要パラメータを設定：
# SITE_NAME=erp.yourdomain.com
# DB_ROOT_USER=root
# DB_ROOT_PASSWORD=your_secure_password
# ADMIN_PASSWORD=your_admin_password

# 5. サービスを起動
docker compose -f compose.yaml \
  -f overrides/compose.mariadb.yaml \
  -f overrides/compose.redis.yaml \
  -f overrides/compose.noproxy.yaml \
  config > ~/docker-compose.yml

docker compose -f ~/docker-compose.yml up -d

# 6. 新サイトを作成
docker compose -f ~/docker-compose.yml exec backend \
  bench new-site erp.yourdomain.com \
  --mariadb-root-password your_secure_password \
  --admin-password your_admin_password \
  --install-app erpnext

# 7. ERPNext にアクセス
# ブラウザで http://your-server-ip:8080 を開く
# デフォルト管理者アカウント：Administrator
# パスワード：.env で設定した ADMIN_PASSWORD

# Let's Encrypt で無料 SSL 証明書を取得
docker compose -f ~/docker-compose.yml exec backend \
  bench setup nginx

# または Traefik で HTTPS を自動管理
docker compose -f compose.yaml \
  -f overrides/compose.traefik.yaml \
  config > ~/docker-compose-traefik.yml

docker compose -f ~/docker-compose-traefik.yml up -d

# 1. 依存関係をインストール
sudo apt update
sudo apt install python3-dev python3-setuptools python3-pip \
  python3-distutils python3.10-venv software-properties-common \
  mariadb-server mariadb-client redis-server nodejs npm \
  yarn cron xvfb libfontconfig wkhtmltopdf

# 2. MariaDB を設定
sudo mysql -u root -e "
  CREATE DATABASE erpnext;
  CREATE USER 'erpnext'@'localhost' IDENTIFIED BY 'your_password';
  GRANT ALL PRIVILEGES ON erpnext.* TO 'erpnext'@'localhost';
  FLUSH PRIVILEGES;
"

# 3. bench（Frappe の CLI ツール）をインストール
pip3 install frappe-bench

# 4. bench を初期化
bench init --frappe-branch version-15 frappe-bench
cd frappe-bench

# 5. 新サイトを作成
bench new-site erp.yourdomain.com \
  --db-name erpnext \
  --db-password your_password \
  --admin-password your_admin_password

# 6. ERPNext アプリをインストール
bench get-app --branch version-15 erpnext
bench --site erp.yourdomain.com install-app erpnext

# 7. 開発サーバーを起動
bench start
# http://localhost:8000 にアクセス

# Frappe API でユーザーを作成（Python スクリプト）
import frappe

user = frappe.get_doc({
    "doctype": "User",
    "email": "zhangsan@company.com",
    "first_name": "張三",
    "roles": [{"role": "Sales Manager"}]
})
user.insert()

# 売上請求書の自動仕訳
借方：売掛金           ¥10,000
    貸方：営業収益         ¥8,849.56
        仮受消費税         ¥1,150.44

# 購買入庫の自動仕訳
借方：商品             ¥5,000
    貸方：買掛金           ¥5,000

# Frappe スクリプトで在庫アラートを設定
frappe.db.set_value("Item", "ITEM-001", "re_order_level", 100)
frappe.db.set_value("Item", "ITEM-001", "warehouse", "本社倉庫")

# 勤怠ルールの設定
attendance_policy = {
    "working_hours": "09:00-18:00",
    "late_entry_threshold": 15,  # 分
    "early_exit_threshold": 15,
    "holiday_list": "2026-法定祝日"
}

# 休暇の種類
leave_types = [
    {"name": "年次有給休暇", "max_leaves": 10},
    {"name": "病気休暇", "max_leaves": 5},
    {"name": "私用休暇", "max_leaves": 0},  # 要承認
    {"name": "結婚休暇", "max_leaves": 3},
]

# 1. 開発用サイトを作成
bench new-site dev.localhost --force
bench use dev.localhost

# 2. カスタムアプリを作成
bench new-app my_custom_app

# ディレクトリ構造：
# my_custom_app/
# ├── my_custom_app/
# │   ├── __init__.py
# │   ├── hooks.py          # アプリフック設定
# │   ├── modules.txt        # モジュールリスト
# │   ├── custom_doctype/    # カスタムドキュメントタイプ
# │   └── api.py             # カスタム API
# └── setup.py

# Python コードで DocType を定義
import frappe
from frappe.model.document import Document

class ProjectTask(Document):
    pass

# hooks.py で登録
# doc_events = {
#     "Project Task": {
#         "on_update": "my_custom_app.tasks.notify_assignee"
#     }
# }

# my_custom_app/api.py
import frappe
from frappe import _

@frappe.whitelist()
def get_project_summary(project_name):
    """プロジェクト概要情報を取得"""
    project = frappe.get_doc("Project", project_name)

    tasks = frappe.get_all("Project Task",
        filters={"project": project_name},
        fields=["task_name", "status", "assigned_to", "deadline"]
    )

    return {
        "project_name": project.project_name,
        "status": project.status,
        "budget": project.budget,
        "tasks": tasks,
        "completion": project.percentage_complete
    }

# 呼び出し方：
# GET /api/method/my_custom_app.api.get_project_summary?project_name=PRJ-001

# 購買承認ワークフローの定義
workflow = {
    "workflow_name": "Purchase Approval",
    "document_type": "Purchase Order",
    "states": [
        {"state": "Draft", "allow_edit": "Purchase Manager"},
        {"state": "Pending Approval", "allow_edit": "Purchase Manager"},
        {"state": "Approved", "allow_edit": "Director"},
        {"state": "Rejected", "allow_edit": "Director"},
    ],
    "transitions": [
        {"from": "Draft", "to": "Pending Approval", "action": "Submit", "allowed": "Purchase Manager"},
        {"from": "Pending Approval", "to": "Approved", "action": "Approve", "allowed": "Director"},
        {"from": "Pending Approval", "to": "Rejected", "action": "Reject", "allowed": "Director"},
    ]
}

# my_custom_app/reports/sales_summary.py
import frappe

def execute(filters=None):
    columns = [
        {"fieldname": "customer", "label": "顧客", "fieldtype": "Link", "options": "Customer", "width": 200},
        {"fieldname": "total_sales", "label": "売上高", "fieldtype": "Currency", "width": 150},
        {"fieldname": "total_qty", "label": "数量", "fieldtype": "Int", "width": 100},
    ]

    conditions = ""
    if filters.get("from_date"):
        conditions += f" AND si.posting_date >= '{filters.from_date}'"
    if filters.get("to_date"):
        conditions += f" AND si.posting_date <= '{filters.to_date}'"

    data = frappe.db.sql(f"""
        SELECT
            si.customer,
            SUM(si.grand_total) as total_sales,
            SUM(si.total_qty) as total_qty
        FROM `tabSales Invoice` si
        WHERE si.docstatus = 1 {conditions}
        GROUP BY si.customer
        ORDER BY total_sales DESC
    """, as_dict=True)

    return columns, data

// カスタムフォームスクリプト
frappe.ui.form.on('Sales Order', {
    refresh: function(frm) {
        // カスタムボタンを追加
        frm.add_custom_button('PDF エクスポート', function() {
            frappe.call({
                method: 'my_custom_app.api.export_pdf',
                args: { docname: frm.doc.name },
                callback: function(r) {
                    window.open(r.message.url);
                }
            });
        });
    },

    validate: function(frm) {
        // カスタムバリデーション
        if (frm.doc.discount > 20) {
            frappe.throw('割引率は 20% を超えることはできません');
        }
    }
});

# サイトをバックアップ
bench --site erp.yourdomain.com backup

# クラウドにバックアップ
bench --site erp.yourdomain.com backup --with-files

# バックアップを復元
bench --site erp.yourdomain.com restore /path/to/database.sql.gz

# 定期バックアップ（crontab に追加）
0 2 * * * cd /home/frappe/frappe-bench && bench backup-all-sites

# 1. Redis キャッシュを有効化（site_config.json で）
{
    "cache_redis": "redis://localhost:6379"
}

# 2. データベースインデックスの最適化
# 高頻度クエリフィールドにインデックスを追加
frappe.db.add_index("Sales Invoice", ["customer", "posting_date"])

# 3. Gunicorn のマルチプロセスを有効化
# bench 設定で設定
bench config set-common-config -c gunicorn_workers 4

# bench ログを確認
bench --site erp.yourdomain.com logs

# MariaDB のスロークエリを確認
mysql -u root -e "SHOW VARIABLES LIKE 'slow_query_log%';"

# サーバーリソースをモニタリング
htop
iotop

# ERPNext REST API の例
import requests

# 顧客リストを取得
response = requests.get(
    "https://erp.yourdomain.com/api/resource/Customer",
    headers={"Authorization": "token api_key:api_secret"}
)
customers = response.json()

# 営業発注書を作成
response = requests.post(
    "https://erp.yourdomain.com/api/resource/Sales Order",
    headers={"Authorization": "token api_key:api_secret", "Content-Type": "application/json"},
    json={"customer": "CUST-001", "items": [{"item_code": "ITEM-001", "qty": 10}]}
)