Skip to main content

Documentation : Mis en place d'une solution type wiki

Pré requis

Création du sous domaine

  1. Plesk > Websites & Domains > Add Subdomain
  2. Nom : wiki → wiki.eythan.fr
  3. Document root : wiki.eythan.fr/httpdocs (par défaut)
  4. OK → sous-domaine actif

Création de la base de données

  1. Plesk > wiki.eythan.fr > Databases > Add Database
  2. Nom : bookstack_db
  3. Utilisateur : bookstack_user
  4. Mot de passe : [fort, noter]
  5. TOUS les privilèges ✓
  6. Noter : DB_DATABASE, DB_USERNAME, DB_PASSWORD

BookStack

Téléchargement

  1. https://github.com/BookStackApp/BookStack/archive/refs/heads/release.zip
  2. Extraire → dossier BookStack-release
  3. Structure attendue : app/, public/, composer.json

Déploiement

  1. Plesk > wiki.eythan.fr > Files > httpdocs/
  2. SUPPRIMER contenu existant
  3. Upload ZIP BookStack → Extract
  4. PHP Composer > SCAN → détecte BookStack
  5. "Install dependencies" → crée vendor/
  6. Vérifier : vendor/autoload.php existe

Laravel

Configuration du .env

Laravel Toolkit > Variables d'environnement :

APP_NAME=BookStack APP_ENV=production APP_URL=https://wiki.eythan.fr

DB_CONNECTION=mysql DB_HOST=localhost DB_DATABASE=bookstack_db DB_USERNAME=bookstack_user DB_PASSWORD=[votre_mdp] DB_PORT=3306

Commandes Artisan (Laravel Toolkit) :

text

  1. php artisan key:generate
  2. php artisan migrate
  3. php artisan storage:link

Permissions

Files > httpdocs/ → 755 sur :

  • storage/
  • bootstrap/cache/
  • public/uploads/ (créer si absent)

Test

URL : https://wiki.eythan.fr

Admin par défaut :

  • Email : admin@admin.com
  • Password : password

⚠️ Admin > Users > Edit → changer mot de passe

Maintenance

Mises à jour : PHP Composer > Update dependencies
✅ .env : Laravel Toolkit > Variables d'environnement
✅ Artisan : Laravel Toolkit > Commandes
✅ Logs : Logs Plesk ou storage/logs/laravel.log