setup.en.md

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 📦

• Node.js >= 10.0.0
• MongoDB >= 3.6

Optional

• Redis
  • Redis is optional, but we strongly recommended to install it
• Elasticsearch - required to enable the search feature

3. Setup MongoDB

As root:

1. mongo Go to the mongo shell
2. use misskey Use the misskey database
3. db.createUser( { user: "misskey", pwd: "<password>", roles: [ { role: "readWrite", db: "misskey" } ] } ) Create the misskey user.
4. exit You're done!

4. Install Misskey

1. su - misskey Connect to misskey user.
2. git clone -b master git://github.com/syuilo/misskey.git Clone the misskey repo from master branch.
3. cd misskey Navigate to misskey directory
4. git checkout $(git tag -l | grep -v 'rc[0-9]*$' | sort -V | tail -n 1) Checkout to the latest release
5. npm install Install misskey dependencies.

5. Configure Misskey

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

6. Build Misskey

Build misskey with the following:

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. npm run build

7. That is it.

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

Launch normally

Just npm start. GLHF!