Papermergeのソースを表示

[[Category:サーバー]]
[[en:Papermerge]]
[https://www.papermerge.com/ Papermerge] はデジタルアーカイブのオープンソースドキュメント管理システムです。

== インストール ==

{{AUR|papermerge}} パッケージをインストールしてください。パッケージのインストール・アップデート時に自動的にデータベースのマイグレーションが実行します。

== 起動 ==
2つの papermerge の [[Systemd#ユニットを使う|systemd ユニット]]を起動・有効化してください:
 # systemctl enable --now papermerge-gunicorn papermerge-worker
起動すると papermerge インスタンスにポート 9001 でアクセスできます。

== 設定 ==
papermerge の設定について詳しくは、公式の [https://papermerge.readthedocs.io/en/latest/index.html ドキュメント] を参照してください。メインの設定ファイルは {{ic|/etc/papermerge.conf.py}} です。
{{Note|{{AUR|papermerge}} パッケージは {{ic|papermerge}} システムユーザーを作成して {{ic|papermerge-manage}} コマンドは常に {{ic|papermerge}} ユーザーで実行します。[[#管理ユーザーの作成|下]]の例を見てください。公式ドキュメントで {{ic|manage.py}} として示しているところでは {{ic|papermerge-manage}} コマンドを使ってください。}}
設定を変更した後は必ず {{ic|papermerge-gunicorn.service}} と {{ic|papermerge-worker.service}} を[[再起動]]してください。

=== 管理ユーザーの作成 ===
最初のインストール後、papermerge インスタンスの管理ユーザーを作成してください:
 $ sudo -u papermerge papermerge-manage createsuperuser

=== Nginx ===
[[Nginx]] をインストールして papermerge のバーチャルホストとして以下の設定を使ってください:
{{hc|/etc/nginx/sites-available/papermerge.domain.tld|2=
server {
    server_name papermerge.domain.tld;
    listen 80;
    listen [::]:80;

    location /static/ {
        alias /var/lib/papermerge/static/;
    }

    location /media/ {
        alias /var/lib/papermerge/media/;
    }

    location / {
        proxy_pass http://127.0.0.1:9001;
    }
}
}}

=== Redis ===
デフォルトのファイルシステムベースの手法の代わりにメッセージブローカとして [[Redis]] を使うことが [https://github.com/ciur/papermerge/issues/198#issuecomment-717712591 推奨] されています。

{{pkg|redis}} と {{pkg|python-redis}} をインストールして {{ic|redis.service}} を[[起動]]・[[有効化]]してください。{{ic|/usr/lib/python3.9/site-packages/config/settings/base.py}} の以下の行を:
{{hc|/usr/lib/python3.9/site-packages/config/settings/base.py|2=
CELERY_BROKER_URL = "filesystem://"
CELERY_BROKER_TRANSPORT_OPTIONS = {
    'data_folder_in': PAPERMERGE_TASK_QUEUE_DIR,
    'data_folder_out': PAPERMERGE_TASK_QUEUE_DIR,
}
}}
以下のように置き換えてください:
{{hc|/usr/lib/python3.9/site-packages/config/settings/base.py|2=
CELERY_BROKER_URL = "redis://"
CELERY_BROKER_TRANSPORT_OPTIONS = {}
CELERY_RESULT_BACKEND = "redis://localhost/0"
}}
それから {{ic|papermerge-gunicorn.service}} と {{ic|papermerge-worker.service}} を[[再起動]]してください。