Sharkey/docs/setup.fr.md

4.2 KiB

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.


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 📦

Optionnels
  • Yarn - recommander pour des raisons de sécurité. Si vous ne l'installez pas, utilisez npx yarn au lieu de yarn.
  • Elasticsearch - requis pour pouvoir activer la fonctionnalité de recherche.
  • FFmpeg

3. Installation de Misskey

  1. Basculez vers l'utilisateur misskey.

    su - misskey

  2. Clonez la branche master du dépôt misskey.

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

  3. Accédez au dossier misskey.

    cd misskey

  4. Checkout sur le tag de la version la plus récente

    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-ledefault.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. yarn install
  4. NODE_ENV=production yarn build
  5. yarn migrate

Si vous rencontrez des difficultés ou avez d'autres questions, n'hésitez pas à nous contacter !