"Le meilleur moyen d'écrire et partager votre savoir en markdown." HedgeDoc

--> Demo : https://demo.hedgedoc.org

Un nouveau petit "service" / #projet_perso en #self_host_hébergement
Pour remplacer vos frampad !
Une bonne #alternativeto aux google.docs et powerpoints...
L'occasion surtout de vous mettre à l'écriture #md_markdown

... Je voulais vérifier mes acquis de la veille au sujet de #Docker
... Merci linuxserver.io pour l'image Armhf #raspberrypi et configs

MAJ

Après une perte de données ( inodes deffectueux ) j'ai décidé de tout reprendre à zerro
: de réinstaller "à la mano"

Objectif :
Refaire sans /Portainer qui, par design... invisibilise des process
: les GUI c'est youpi mais ça ne nous dit pas tout ( c'est moins verbeux )

/PostgreSQL plutôt que /MYSQL

Le premier charge la base depuis un fichier...
il est beaucoup plus facile à mettre en place !

L'intéret ici c'est qu'on lance les deux services d'afilée
: la base de donnée puis /HedgeDoc

Source :
https://github.com/linuxserver/docker-hedgedoc/issues/7
mixée avec
https://docs.linuxserver.io/images/docker-hedgedoc

CONFIG

On lance avec :
docker-compose up --remove-orphans

Dans le dossier contenant docker-compose.yml :

--
version: "2.1"
services:
  database:
    image: postgres:latest
    container_name: hedgedoc_db
    restart: unless-stopped
    volumes:
      - <PATH>/data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=hedgedoc
      - POSTGRES_DB=hedgedoc
      - POSTGRES_PASSWORD=<PASSWORD>
  hedgedoc:
    image: lscr.io/linuxserver/hedgedoc:latest
    container_name: hedgedoc
    environment:
      - PUID=1000
      - PGID=1000
      - CMD_DB_URL=postgres://hedgedoc:<PASSWORD>@hedgedoc_db:5432/hedgedoc
      - TZ=Europe/Paris
      - CMD_DOMAIN=<HOST>
      - CMD_URL_ADDPORT=false
      - CMD_PROTOCOL_USESSL=true
      - CMD_PORT=3999 #optional
      - CMD_ALLOW_ORIGIN=['localhost','<IP_ALT>','<HOST>']
    volumes:
      - <PATH>:/config
    ports:
      - 3999:3999
    restart: unless-stopped

NOTES

• Mon domaine = <HOST>
  pad.vincent-bonnefille.fr ( à remplacer )
• Mon Volume (chemin d'accès) = <PATH> ( idem )
• On peut autoriser certains domaines à afficher les contenus
  .... utilise si on dev' ( ex: <IP_ALT> )
• NB : J'uitilise le port 3999 ( 3000 est pris par #nodejs )

AJOUTS

J'ai aussi ajouté une connexion avec l'API de /Github + /Nexcloud

• https://docs.hedgedoc.org/guides/auth/github/
• https://docs.hedgedoc.org/guides/auth/nextcloud/

NB: pour github j'ai du ajouter ( Source ) :
CMD_URL_ADDPORT=false
CMD_PROTOCOL_USESSL=true
( sinon j'avais un "mismatch" d'URL de /callback/ )

Et une un "code/id" de session
( pour reprendre après reboot )

• CMD_SESSION_SECRET

RESSOURCES

• Postg / mysql / service / tips ( <3 ) :
  https://deleteonerror.com/2021/04/how-to-install-hedgedoc/
• Doc Officielles, config options
  https://docs.hedgedoc.org/configuration/