2e55aea584
* Doc: Update setup documents Use GitHub api to checkout latest release instead of "git tag" command which cannot accurately determine prerelease tag. Also, Changed numbered list format because the shell command is too long to fit on one line. * Doc: Use tab instead of spaces * Doc: Use master branch as latest release tag master branch and latest release is the same. master branch merges develop branch with each latest release.
133 lines
3.9 KiB
Markdown
133 lines
3.9 KiB
Markdown
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)
|
|
|
|
----------------------------------------------------------------
|
|
|
|
*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/)** >= 11.7.0
|
|
* **[PostgreSQL](https://www.postgresql.org/)** >= 10
|
|
* **[Redis](https://redis.io/)**
|
|
|
|
##### Optionnels
|
|
* [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 -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](https://github.com/syuilo/misskey/releases/latest)
|
|
|
|
`git checkout master`
|
|
|
|
5. Installez les dépendances de misskey.
|
|
|
|
`npm 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 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. `npm install`
|
|
4. `NODE_ENV=production npm run build`
|
|
5. Consultez [ChangeLog](../CHANGELOG.md) pour les information de migration.
|
|
|
|
----------------------------------------------------------------
|
|
|
|
Si vous rencontrez des difficultés ou avez d'autres questions, n'hésitez pas à nous contacter !
|