Sharkey/docs/setup.en.md
かひわし4(バージョン1) 2e55aea584 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

3.5 KiB

Misskey Setup and Installation Guide

We thank you for your interest in setting up your Misskey server! This guide describes how to install and setup Misskey.

Japanese version also available - 日本語版もあります


1. Create Misskey user

Running misskey as root is not a good idea so we create a user for that. In debian for exemple :

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

2. Install dependencies

Please install and setup these softwares:

Dependencies 📦

Optional

3. Install Misskey

  1. Connect to misskey user.

    su - misskey

  2. Clone the misskey repo from master branch.

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

  3. Navigate to misskey directory

    cd misskey

  4. Checkout to the latest release

    git checkout master

  5. Install misskey dependencies.

    npm install

4. Configure Misskey

  1. Copy the .config/example.yml and rename it to default.yml.

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

  2. Edit default.yml

5. Build Misskey

Build misskey with the following:

NODE_ENV=production npm run build

If you're on Debian, you will need to install the build-essential, python package.

If you're still encountering errors about some modules, use node-gyp:

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

6. Init DB

npm run init

7. That is it.

Well done! Now, you have an environment that run to Misskey.

Launch normally

Just NODE_ENV=production npm start. GLHF!

Launch with systemd

  1. Create a systemd service here

    /etc/systemd/system/misskey.service

  2. Edit it, and paste this and save:

    [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
    
  3. Reload systemd and enable the misskey service.

    systemctl daemon-reload ; systemctl enable misskey

  4. Start the misskey service.

    systemctl start misskey

You can check if the service is running with systemctl status misskey.

How to update your Misskey server to the latest version

  1. git checkout master
  2. git pull
  3. npm install
  4. NODE_ENV=production npm run build
  5. Check ChangeLog for migration information
  6. Restart your Misskey process to apply changes
  7. Enjoy

If you have any questions or troubles, feel free to contact us!