misskey-awawa/docs/setup.fr.md

3.9 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.

La version en japonnais est également disponible sur - 日本語版もあります


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é
  • 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.

    npx 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 npm run 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. npm install -g node-gyp
  2. node-gyp configure
  3. node-gyp build
  4. NODE_ENV=production npm run build

6. C'est tout.

Excellent ! Maintenant, vous avez un environnement prêt pour lancer Misskey

Lancement conventionnel

Lancez tout simplement NODE_ENV=production npm 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. npx yarn install
  4. NODE_ENV=production npm run build
  5. npm run migrate

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