{{tag>software docker}}

====== Organizr ======

Organizr est un application web permettant de regrouper et d'organiser ses web services.


===== Tester l'image =====

Il existe une image docker, la commande ci-dessous permet de lancer manuellement un conteneur éphémère pour test sur un port local 8081:
<code bash>
mkdir organizr

cd organizr/

docker run --rm --name=organizr --detach  \
  -v $(pwd):/config   -e PGID=1000 -e PUID=1000 \
  -p 8081:80   -e fpm="false" organizr/organizr
</code>

PGID et PUID doivent correspondre à votre utilisateur courant afin que les fichiers créés via le mapping soient accessibles.

Une fois le compte admin paramétré, on peut créer un utilisateur sans privilèges.


===== Création du service via docker-compose =====

Le fichier docker-compose ci-dessous propose de créer un service et un volume
<file yaml docker-compose.yml>
version: "3.3"

services:
  organizr:
    image: "organizr/organizr"
    container_name: "organizr"
    restart: always
    environment:
      - PGID=1000
      - PUID=1000
      - fpm="false"
    networks:
      - http_loadbalancing_default
    expose:
      - 80
    volumes:
      - type: volume
        source: organizr_datavol
        target: /config
    labels:
      - "traefik.http.routers.organizr.rule=Host(`organizr.localhost`)"
      - "traefik.http.services.ornganizr.loadbalancer.server.port=80"
      - "traefik.http.routers.organizr.entrypoints=http"
      - "traefik.docker.network=http_loadbalancing_default"
    
volumes:
  organizr_datavol:

networks:
  http_loadbalancing_default:
    external:
      name: http_loadbalancing_default
</file>

===== Configuration et stockage =====

Lors de l'installation le nom du fichier de base de données (format SQLite3) est renseigné par l'administrateur.

<note warning>
Utiliser un mot de passe d'administration spécifique au service. Le fichier de configuration **/config/www/organizr/api/config/config.php** conserve cette valeur en clair via la clé **'organizrHash'**.
</note>

===== Démarrage =====

Via le compte d'administration:
  * Déclarer un onglet par service web. Un onglet pour être visible doit être activé et associé au groupe de l'utilisateur.
  * Les onglets peuvent être regroupés par Catégories.

===== Ajouter des icônes de services =====

Quelle que soit la dimension, les images doivent avoir même longueur et largeur.

Depuis un compte d'administration:
  * Onglet Settings
  * Gestionnaire d'images
  * 
===== Références =====

  * https://docs.organizr.app/shelves/organizr-docs
  * https://registry.hub.docker.com/r/organizr/organizr