Installer Neko avec Docker

zarev 16 juin 2025 6 min de lecture

Table des matières

Comme vous vous en doutez à l'image, cette application vous permettra de sonder la santé de votre chat simplement en regardant son... Heu... Anus. Ah non, pardon, je me trompe avec une autre application.

Aujourd'hui nous allons parler de Neko ! Le résumer à un simple navigateur virtuel serait aller vite en besogne. Il permet bien plus que cela.

Vous pouvez inviter des personnes sur votre instance, discuter par chat, présenter un projet, une application web, que vous ayez besoin de collaborer sur un projet, d'accéder à des ressources partagées ou que vous souhaitiez simplement partager l'accès à un navigateur avec des amis ou des membres de votre famille, Neko vous facilite la tâche.

Sous son air innocent, il y a vraiment moyen de faire énormément de choses. Je ne peux pas tout aborder dans ce tutoriel car ça serait extrêmement long, je vous invite à consulter cette page :

⚡ Caractéristiques

Watch party : Regardez un contenu vidéo avec plusieurs personnes et y réagir (chat, emotes) - alternative open source à giggl.app ou hyperbeam.
Présentation interactive : Non seulement partage d'écran, mais aussi contrôle de l'écran par d'autres personnes.
Outil de collaboration : Brainstorming, cobrowsing, débogage de code en commun.
Soutien/enseignement : Guider interactivement des personnes dans un environnement contrôlé.
Intégrer n'importe quoi : Intégrez un navigateur virtuel dans votre application web, alternative open source à l'API hyperbeam.
Ouvrez n'importe quel site web ou application tierce, synchronisez l'audio et la vidéo de manière parfaite entre plusieurs participants.
...

💾 Installation

Prérequis

Avant de commencer, assurez-vous d’avoir :

Distribution Linux (Ubuntu, Debian, etc ...).
Docker installé.
Accès terminal.
Connexion internet.

Étapes d'Installation

Créez votre compose.yml dans le dossier ou vous comptez installer Neko :

nano compose.yml

Et collez ça dedans :

services:
  neko:
    image: ghcr.io/m1k1o/neko/firefox:latest
    restart: unless-stopped
    ports:
      - "8022:8080"
      - "52000-52100:52000-52100/udp"
    volumes:
      - ./data:/home/neko/.mozilla/firefox
    environment:  
      NEKO_WEBRTC_NAT1TO1: "127.0.0.1"
      NEKO_MEMBER_MULTIUSER_USER_PASSWORD: "neko"  
      NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD: "admin"
      NEKO_WEBRTC_EPR: 52000-52100
      NEKO_WEBRTC_ICELITE: 1
      NEKO_WEBRTC_NAT1TO1: votre_ip

- ./data:/home/neko/.mozilla/firefox => Permet la persistance des données. Si vous ne souhaitez pas cette option, supprimez ou commentez la ligne.
NEKO_MEMBER_MULTIUSER_USER_PASSWORD: "neko" => Changez neko par un nom d'utilisateur propre à vous.
NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD: "admin" => Changez admin par un mot de passe (fort) propre à vous.
NEKO_WEBRTC_NAT1TO1: votre_ip => Indiquez l'ip de votre serveur.

On va déployer l'application :

docker compose up -d

Rendez-vous sur l'ip:port, suivant l'IP de votre serveur local et du port choisi, 8022 par défaut :

http://ip:8022

ou votre domaine :

https://neko.mondomaine.com

🔌 Première connexion

Et bien oui, il faudra commencer par vous connecter. C'est révolutionnaire, ne bougez pas, je vous explique tout.

1 => Entrez le nom d'utilisateur choisi dans le compose.
2 => Entrez le mot de passe choisi dans le compose.
3 => Cliquez sur CONNEXION pour vous connecter.

Vous voilà sur votre tableau de bord :

Vous pouvez à présent naviguer :

🔏 Débloquer le navigateur

La première chose qui va vous frapper, c'est qu'à première vue, tout semble bloqué. Ou alors c'est moi qui suis con, mais j'ai cherché quelques secondes comment résoudre ce mystère.

En réalité, c'est très simple, il suffit de demander pour prendre le contrôle en cliquant sur l'icône clavier :

Ce qui va activer le contrôle du navigateur :

💻 Choisir la résolution

Il est possible de choisir la résolution en cliquant si l'icone écran en haut à droite :

Sélectionnez la résolution souhaitée :

🐱 Utiliser le chat

Qui dit partage d'écran dit discuter, bien souvent. Il est aisé de lancer une fenêtre de discussion avec les personnes présentes.

Cliquez sur les trois lignes horizontales, situées dans le coin supérieur droit :

Tapez votre message et validez avec la touche Entrée/Enter de votre clavier :

Si vous voulez exprimer votre joie, votre peine, votre colère, en grand, cliquez sur le smiley et choisissez celui que vous voulez :

C'est de toute beauté, n'est-ce pas ?

🔧 Paramètres utiles

Situé à côté de l'onglet Chat, cliquez sur Paramètres :

Réglez à votre meilleure convenance les paramètres.

🌎 Reverse proxy

Suivant ce que vous utilisez, référez vous à cette page :

🍀 Bonus, partager VLC

Vous avez envie de regarder un film avec une personne de votre choix ? C'est très simple.

Étapes d'Installation

Créez votre compose.yml dans le dossier ou vous comptez installer Neko :

nano compose.yml

Et collez ça dedans :

services:
  neko:
    image: "ghcr.io/m1k1o/neko/vlc:latest"
    restart: "unless-stopped"
    shm_size: "2gb"
    cap_add:
      - SYS_ADMIN
    volumes:
      - "./videos:/video"
    ports:
      - "8022:8080"
      - "52000-52100:52000-52100/udp"
    environment:
      NEKO_MEMBER_MULTIUSER_USER_PASSWORD: neko
      NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD: admin
      NEKO_WEBRTC_EPR: 52000-52100
      NEKO_WEBRTC_ICELITE: 1
      NEKO_WEBRTC_NAT1TO1: votre_ip