Skip to content
Go to file
* Simplified Chinese Install & Setup Guides Added

* Using lists in navigation between languages

* (Delete a closing bracket added by mistake

Co-authored-by: Candinya <>
13 contributors

Users who have contributed to this file

@syuilo @AyaMorisawa @angristan @skid9000 @acid-chicken @khws4v1 @CookieRamen @mei23 @Candinya @incognico @akihikodaki @l2dy
146 lines (100 sloc) 3.81 KB

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.

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 ๐Ÿ“ฆ

  • Yarn Optional but recommended for security reason. If you won't install it, use npx yarn instead of yarn.
  • Elasticsearch - required to enable the search feature
  • FFmpeg

3. Install Misskey

  1. Connect to misskey user.

    su - misskey

  2. Clone the misskey repo from master branch.

    git clone -b master git://

  3. Navigate to misskey directory

    cd misskey

  4. Checkout to the latest release

    git checkout master

  5. Install misskey dependencies.


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 yarn 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. npx node-gyp configure
  2. npx node-gyp build
  3. NODE_ENV=production yarn build

6. Init DB

yarn 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


  2. Edit it, and paste this and save:

    Description=Misskey daemon
    ExecStart=/usr/bin/npm start
  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. yarn install
  4. NODE_ENV=production yarn build
  5. yarn migrate
  6. Restart your Misskey process to apply changes
  7. Enjoy

If you encounter any problems with updating, please try the following:

  1. yarn clean or yarn cleanall
  2. Retry update (Don't forget yarn install

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

You canโ€™t perform that action at this time.