jointrashposs/content/ko/docs/3.for-admin/install/guides/manual.md

description
このガイドではMisskeyのインストール・セットアップ方法について解説します。

Misskeyを手動で構築する

このガイドではMisskeyのインストール・セットアップ方法について解説します。

:::danger 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ :::

:::tip{label='前提条件'}

以下のソフトウェアがインストール・設定されていること

• Node.js (20.4.x以上)
• PostgreSQL (15以上)
• Redis
• FFmpeg

Debian/Ubuntuをお使いであれば、build-essentialパッケージをインストールしておくと良いです。

corepackが有効化されていること

sudo corepack enable

:::

ユーザーの作成

Misskeyはrootユーザーで実行しない方がよいため、代わりにユーザーを作成します。 Debianの例:

adduser --disabled-password --disabled-login misskey

Misskeyのインストール

sudo -iu misskey
git clone --recursive https://github.com/misskey-dev/misskey.git
cd misskey
git checkout master
git submodule update --init
NODE_ENV=production pnpm install --frozen-lockfile

設定

設定サンプルの.config/example.ymlをコピーし、default.ymlにリネームします。

cp .config/example.yml .config/default.yml

default.yml をファイル内の指示に従って編集します。

ビルドと初期化

次のコマンドでMisskeyのビルドとデータベースの初期化を行います。 これにはしばらく時間がかかります。

NODE_ENV=production pnpm run build
pnpm run init

起動

お疲れ様でした。以下のコマンドでMisskeyを起動できます。

NODE_ENV=production pnpm run start

GLHF✨

::::g-details{summary="systemdを用いた管理"}

systemdサービスのファイルを作成

/etc/systemd/system/misskey.service

エディタで開き、以下のコードを貼り付けて保存:

[Unit]
Description=Misskey daemon

[Service]
Type=simple
User=misskey
ExecStart=/usr/bin/npm start
WorkingDirectory=/home/misskey/misskey
Environment="NODE_ENV=production"
TimeoutSec=60
StandardOutput=journal
StandardError=journal
SyslogIdentifier=misskey
Restart=always

[Install]
WantedBy=multi-user.target

:::warning CentOSで1024以下のポートを使用してMisskeyを使用する場合はExecStart=/usr/bin/sudo /usr/bin/npm startに変更する必要があります。 :::

systemdを再読み込みしmisskeyサービスを有効化

sudo systemctl daemon-reload
sudo systemctl enable misskey

misskeyサービスの起動

sudo systemctl start misskey

:::tip systemctl status misskeyと入力すると、サービスの状態を調べることができます。 :::

Misskeyのアップデート方法

:::warning アップデートの際は必ずリリースノートを確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 :::

masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います:

git checkout master
git pull
git submodule update --init
NODE_ENV=production pnpm install --frozen-lockfile
NODE_ENV=production pnpm run build
pnpm run migrate

アップデート内容、およびデータベースの規模によっては時間がかかることがあります。

アップデートが終わり次第、Misskeyプロセスを再起動してください。

sudo systemctl restart misskey

:::tip ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください:

• pnpm run cleanまたはpnpm run clean-all
• pnpm rebuild :::