cherrypick/docs/setup.ja.md
rinsuki 350310c4c2 ドキュメントのNode.js最小バージョンを修正 (#5700)
@typescript-eslint/parserが11.10.1以上じゃないと入らない

> error @typescript-eslint/parser@2.3.3: The engine "node" is incompatible with this module. Expected version "^8.10.0 || ^10.13.0 || >=11.10.1". Got "11.7.0"

https://github.com/syuilo/misskey/runs/274115939
2020-01-09 17:46:29 +09:00

4.5 KiB
Raw Blame History

Misskey構築の手引き

Misskeyサーバーの構築にご関心をお寄せいただきありがとうございます このガイドではMisskeyのインストール・セットアップ方法について解説します。

英語版もあります - English version also available


1. Misskeyユーザーの作成

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

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

2. 依存関係をインストールする

これらのソフトウェアをインストール・設定してください:

依存関係 📦

オプション
  • Yarn
    • セキュリティの観点から推奨されます。 yarn をインストールしない方針の場合は、文章中の yarn を適宜 npx yarn と読み替えてください。
  • Elasticsearch
    • 検索機能を有効にするためにはインストールが必要です。
  • FFmpeg

3. Misskeyのインストール

  1. misskeyユーザーを使用

    su - misskey

  2. masterブランチからMisskeyレポジトリをクローン

    git clone -b master git://github.com/syuilo/misskey.git

  3. misskeyディレクトリに移動

    cd misskey

  4. 最新のリリースを確認

    git checkout master

  5. Misskeyの依存パッケージをインストール

    yarn install

4. 設定ファイルを作成する

  1. .config/example.ymlをコピーし名前をdefault.ymlにする。

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

  2. default.yml を編集する。

5. Misskeyのビルド

次のコマンドでMisskeyをビルドしてください:

NODE_ENV=production yarn build

Debianをお使いであれば、build-essentialパッケージをインストールする必要があります。

何らかのモジュールでエラーが発生する場合はnode-gypを使ってください:

  1. npx node-gyp configure
  2. npx node-gyp build
  3. NODE_ENV=production yarn build

6. データベースを初期化

yarn run init

7. 以上です!

お疲れ様でした。これでMisskeyを動かす準備は整いました。

通常起動

NODE_ENV=production yarn startするだけです。GLHF!

systemdを用いた起動

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

    /etc/systemd/system/misskey.service

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

    [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=syslog
    StandardError=syslog
    SyslogIdentifier=misskey
    Restart=always
    
    [Install]
    WantedBy=multi-user.target
    

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

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

    systemctl daemon-reload; systemctl enable misskey

  4. misskeyサービスの起動

    systemctl start misskey

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

Misskeyを最新バージョンにアップデートする方法:

  1. git checkout master
  2. git pull
  3. yarn install
  4. NODE_ENV=production yarn build
  5. yarn migrate

なにか問題が発生した場合は、yarn cleanまたはyarn cleanallすると直る場合があります。


なにかお困りのことがありましたらお気軽にご連絡ください。