4.3 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
- Redis
- Redis est optionnel mais nous vous recommandons vivement de l'installer
- Elasticsearch - requis pour pouvoir activer la fonctionnalité de recherche
3. Paramètrage de MongoDB
En root :
mongo
Ouvrez le shell mongouse misskey
Utilisez la base de données misskeydb.users.save( {dummy:"dummy"} )
Écrivez une donnée factice pour initialiser la base de données.db.createUser( { user: "misskey", pwd: "<password>", roles: [ { role: "readWrite", db: "misskey" } ] } )
Créez l'utilisateur misskey.exit
Vous avez terminé !
4. Installation de Misskey
su - misskey
Basculez vers l'utilisateur misskey.git clone -b master git://github.com/syuilo/misskey.git
Clonez la branche master du dépôt misskey.cd misskey
Accédez au dossier misskey.git checkout $(git tag -l | grep -v 'rc[0-9]*$' | sort -V | tail -n 1)
Checkout sur le tag de la version la plus récentenpm install
Installez les dépendances de misskey.
5. Création du fichier de configuration
cp .config/example.yml .config/default.yml
Copiez le fichier.config/example.yml
et renommez-ledefault.yml
.- Editez le fichier
default.yml
6. Construction de Misskey
Construisez Misskey comme ceci :
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:
npm install -g node-gyp
node-gyp configure
node-gyp build
npm run build
7. C'est tout.
Excellent ! Maintenant, vous avez un environnement prêt pour lancer Misskey
Lancement conventionnel
Lancez tout simplement npm start
. Bonne chance et amusez-vous bien !
Démarrage avec systemd
- Créez un service systemd sur :
/etc/systemd/system/misskey.service
- 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
TimeoutSec=60
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=misskey
Restart=always
[Install]
WantedBy=multi-user.target
systemctl daemon-reload ; systemctl enable misskey
Redémarre systemd et active le service misskey.systemctl start misskey
Démarre le service 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
git fetch
git checkout $(git tag -l | grep -v 'rc[0-9]*$' | sort -V | tail -n 1)
npm install
npm run build
- Consultez ChangeLog pour les information de migration.
Si vous rencontrez des difficultés ou avez d'autres questions, n'hésitez pas à nous contacter !