Guide d'installation et de configuration de Misskey ================================================================ Nous vous remerçions de l'intrêt que vous manifestez pour l'installation de votre propre instance Misskey ! Ce guide décrit les étapes à suivre afin d'installer et de configurer une instance Misskey. - [La version en japonnais est également disponible sur - 日本語版もあります](./setup.ja.md) - [Version anglaise également disponible - English version also available - 英語版もあります](./setup.en.md) - [Version Chinois simplifié également disponible - Simplified Chinese version also available - 简体中文版同样可用](./setup.zh.md) ---------------------------------------------------------------- *1.* Création de l'utilisateur Misskey ---------------------------------------------------------------- Executer misskey en tant que super-utilisateur étant une mauvaise idée, nous allons créer un utilisateur dédié. Sous Debian, par exemple : ``` adduser --disabled-password --disabled-login misskey ``` *2.* Installation des dépendances ---------------------------------------------------------------- Installez les paquets suivants : #### Dépendences :package: * **[Node.js](https://nodejs.org/en/)** (12.x, 14.x) * **[PostgreSQL](https://www.postgresql.org/)** (>= 10) * **[Redis](https://redis.io/)** ##### Optionnels * [Yarn](https://yarnpkg.com/) - *recommander pour des raisons de sécurité. Si vous ne l'installez pas, utilisez `npx yarn` au lieu de` yarn`.* * [Elasticsearch](https://www.elastic.co/) - *requis pour pouvoir activer la fonctionnalité de recherche.* * [FFmpeg](https://www.ffmpeg.org/) *3.* Installation de Misskey ---------------------------------------------------------------- 1. Basculez vers l'utilisateur misskey. `su - misskey` 2. Clonez la branche master du dépôt misskey. `git clone --recursive -b master git://github.com/misskey-dev/misskey.git` 3. Accédez au dossier misskey. `cd misskey` 4. Checkout sur le tag de la [version la plus récente](https://github.com/misskey-dev/misskey/releases/latest) `git checkout master` 5. Installez les dépendances de misskey. `yarn install` *4.* Création du fichier de configuration ---------------------------------------------------------------- 1. Copiez le fichier `.config/example.yml` et renommez-le`default.yml`. `cp .config/example.yml .config/default.yml` 2. Editez le fichier `default.yml` *5.* Construction de Misskey ---------------------------------------------------------------- Construisez Misskey comme ceci : `NODE_ENV=production yarn build` Si vous êtes sous Debian, vous serez amené à installer les paquets `build-essential` et `python`. Si vous rencontrez des erreurs concernant certains modules, utilisez node-gyp: 1. `npx node-gyp configure` 2. `npx node-gyp build` 3. `NODE_ENV=production yarn build` *6.* C'est tout. ---------------------------------------------------------------- Excellent ! Maintenant, vous avez un environnement prêt pour lancer Misskey ### Lancement conventionnel Lancez tout simplement `NODE_ENV=production yarn start`. Bonne chance et amusez-vous bien ! ### Démarrage avec systemd 1. Créez un service systemd sur `/etc/systemd/system/misskey.service` 2. Editez-le puis copiez et coller ceci dans le fichier : ``` [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. Redémarre systemd et active le service misskey. `systemctl daemon-reload ; systemctl enable misskey` 4. Démarre le service misskey. `systemctl start misskey` Vous pouvez vérifier si le service a démarré en utilisant la commande `systemctl status misskey`. ### Méthode de mise à jour vers la plus récente version de Misskey 1. `git checkout master` 2. `git pull` 3. `git submodule update --init` 4. `yarn install` 5. `NODE_ENV=production yarn build` 6. `yarn migrate` ---------------------------------------------------------------- Si vous rencontrez des difficultés ou avez d'autres questions, n'hésitez pas à nous contacter !