Guide d’installation KiwiIRC

KiwiIRC est une interface web moderne et responsive pour se connecter à un réseau IRC. Ce guide vous montre comment installer votre propre instance KiwiIRC sur un serveur Debian/Ubuntu.

Prérequis

  • Un serveur Debian ou Ubuntu (VPS/Dédié).
  • Node.js et npm installés.
  • Un accès SSH avec droits sudo.
  • Un nom de domaine ou sous-domaine pointant vers votre serveur.

Astuce : utilisez un sous-domaine dédié comme kiwi.votredomaine.com.

Installation rapide

1) Mettre à jour le système

sudo apt update && sudo apt upgrade -y

2) Installer Node.js et npm

sudo apt install -y nodejs npm

3) Télécharger KiwiIRC depuis GitHub

git clone https://github.com/kiwiirc/kiwiirc.git
cd kiwiirc

4) Installer les dépendances

npm install

5) Compiler le projet

npm run build

Configuration

Le fichier principal de configuration est config.json situé à la racine du projet.

Exemple minimal :

{
  "server": "irc.votredomaine.com",
  "port": 6697,
  "ssl": true,
  "theme": "default"
}

⚠️ Adaptez les valeurs à votre réseau IRC et activez SSL si possible.

Lancement

1) Lancer en mode direct

npm start

Par défaut, KiwiIRC sera accessible sur http://localhost:7778.

2) Utiliser un service systemd

sudo nano /etc/systemd/system/kiwiirc.service

Contenu recommandé :

[Unit]
Description=KiwiIRC
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/home/votreuser/kiwiirc
ExecStart=/usr/bin/npm start
Restart=always

[Install]
WantedBy=multi-user.target

Activez et démarrez le service :

sudo systemctl enable kiwiirc
sudo systemctl start kiwiirc

Liens utiles