iceshrimp/docs/setup.ja.md
かひわし4(バージョン1) 9c3f765343 Doc: Update setup documents (#4680)
* Doc: Update setup documents

Use GitHub api to checkout latest release instead of "git tag" command
which cannot accurately determine prerelease tag.
Also, Changed numbered list format because
the shell command is too long to fit on one line.

* Doc: Use tab instead of spaces

* Doc: Use master branch as latest release tag

master branch and latest release is the same.
master branch merges develop branch with each latest release.
2019-04-17 02:15:27 +09:00

4.3 KiB
Raw Blame History

Misskey構築の手引き

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

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


1. Misskeyユーザーの作成

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

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

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

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

依存関係 📦

オプション
  • 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の依存パッケージをインストール

    npm install

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

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

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

  2. default.yml を編集する。

5. Misskeyのビルド

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

NODE_ENV=production npm run build

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

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

  1. npm install -g node-gyp
  2. node-gyp configure
  3. node-gyp build
  4. NODE_ENV=production npm run build

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

npm run init

7. 以上です!

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

通常起動

NODE_ENV=production npm 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. npm install
  4. NODE_ENV=production npm run build
  5. ChangeLogでマイグレーション情報を確認する

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


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