Installation locale

Choisir comment installer Linkr sur votre machine : Docker, installation manuelle ou mode client-only.

En résumé

Trois méthodes d’installation. La plus simple, et celle que nous recommandons, est Docker : un fichier à télécharger, une commande, et Linkr tourne — ni dépôt à cloner, ni rien à compiler. L’installation manuelle (Python + Node.js) donne la même chose sans Docker, pour développer. Enfin, le mode client-only ne demande que Node.js : plus limité, mais suffisant pour découvrir Linkr ou publier un site statique.

Client Backend

Choisir une méthode

Docker Recommandé

Toutes les fonctionnalités, rien à construire. Les images sont publiées sur Docker Hub : un fichier, une commande, et Linkr tourne. Convient aussi pour un serveur.

~5 min, plus le téléchargement des images (~780 Mo) Prérequis : Docker

curl -O https://framagit.org/interhop/linkr/linkr/-/raw/main/docker/docker-compose.hub.yml
echo "LINKR_SECRET_KEY=$(python3 -c 'import secrets; print(secrets.token_urlsafe(48))')" > .env
docker compose -f docker-compose.hub.yml up

Guide complet

Installation manuelle Pour développer

Les mêmes fonctionnalités, sans Docker : le backend Python et le frontend tournent directement sur votre machine, avec rechargement à chaud.

~15 min Prérequis : Node.js 20+Python 3.12+Git

git clone https://framagit.org/interhop/linkr/linkr.git && cd linkr
npm install
python3 -m venv apps/api/.venv && source apps/api/.venv/bin/activate
pip install -e "apps/api[dev]"
# puis les deux fichiers de configuration, voir le guide
npm run dev:all

Guide complet

Client-only Le plus léger

Tout tourne dans le navigateur : ni backend, ni comptes, ni entrepôt distant. Pour découvrir Linkr, travailler seul·e sur des fichiers locaux, ou publier un site statique.

~5 min Prérequis : Node.js 20+Git

git clone https://framagit.org/interhop/linkr/linkr.git && cd linkr
npm install
npm run dev:web

Guide complet

Comparer les trois méthodes

	Docker	Manuelle	Client-only
Comptes utilisateurs et partage	✓	✓	—
Entrepôt de données distant	✓	✓	—
Versioning Git	✓	✓	—
Rien à compiler	✓	—	—
Rechargement à chaud (développement)	—	✓	✓
Publication en site statique	—	—	✓

Le détail de ce que chaque mode permet est dans Modes de déploiement.

Juste pour essayer ?

Rien à installer : la démo en ligne fait tourner Linkr directement dans votre navigateur, avec des données d’exemple.

Pour aller plus loin

Déployer une instance pour votre équipe ou votre établissement : Installation en production.
Créer votre premier projet : Votre premier projet.