Sharkey/docs/setup.fr.md

137 lines
4.2 KiB
Markdown
Raw Normal View History

2018-11-13 16:15:33 +01:00
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)
2018-11-13 16:15:33 +01:00
----------------------------------------------------------------
*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 :
2018-11-13 16:15:33 +01:00
```
adduser --disabled-password --disabled-login misskey
```
*2.* Installation des dépendances
----------------------------------------------------------------
Installez les paquets suivants :
#### Dépendences :package:
2020-05-23 16:19:16 +02:00
* **[Node.js](https://nodejs.org/en/)** (12.x, 14.x)
* **[PostgreSQL](https://www.postgresql.org/)** (>= 10)
2019-04-13 12:19:32 +02:00
* **[Redis](https://redis.io/)**
2018-11-13 16:15:33 +01:00
##### 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.*
2019-02-05 06:24:10 +01:00
* [FFmpeg](https://www.ffmpeg.org/)
2018-11-13 16:15:33 +01:00
2019-04-13 12:19:32 +02:00
*3.* Installation de Misskey
2018-11-13 16:15:33 +01:00
----------------------------------------------------------------
1. Basculez vers l'utilisateur misskey.
`su - misskey`
2. Clonez la branche master du dépôt misskey.
2021-03-24 04:23:05 +01:00
`git clone -b master git://github.com/misskey-dev/misskey.git`
3. Accédez au dossier misskey.
`cd misskey`
2021-03-24 04:23:05 +01:00
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`
2018-11-13 16:15:33 +01:00
2019-04-13 12:19:32 +02:00
*4.* Création du fichier de configuration
2018-11-13 16:15:33 +01:00
----------------------------------------------------------------
1. Copiez le fichier `.config/example.yml` et renommez-le`default.yml`.
`cp .config/example.yml .config/default.yml`
2018-11-13 16:15:33 +01:00
2. Editez le fichier `default.yml`
2019-04-13 12:19:32 +02:00
*5.* Construction de Misskey
2018-11-13 16:15:33 +01:00
----------------------------------------------------------------
Construisez Misskey comme ceci :
`NODE_ENV=production yarn build`
2018-11-13 16:15:33 +01:00
Si vous êtes sous Debian, vous serez amené à installer les paquets `build-essential` et `python`.
2018-11-13 16:15:33 +01:00
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`
2018-11-13 16:15:33 +01:00
2019-04-13 12:19:32 +02:00
*6.* C'est tout.
2018-11-13 16:15:33 +01:00
----------------------------------------------------------------
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 !
2018-11-13 16:15:33 +01:00
### Démarrage avec systemd
1. Créez un service systemd sur
`/etc/systemd/system/misskey.service`
2018-11-13 16:15:33 +01:00
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.
2018-11-13 16:15:33 +01:00
`systemctl start misskey`
2018-11-13 16:15:33 +01:00
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`
2018-11-13 16:15:33 +01:00
----------------------------------------------------------------
Si vous rencontrez des difficultés ou avez d'autres questions, n'hésitez pas à nous contacter !