Masquer les derniers auteurs
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | Tableau de bord d'accueil : liens vers tous les services auto-hébergés, avec leur état en direct et des widgets. |
| 2 | |||
| 3 | == Fonctionnalités utilisées == | ||
| 4 | |||
| 5 | * Sections et liens vers les services, avec icônes stockées en local. | ||
| 6 | * Indicateur d'état de chaque service (vérification de disponibilité). | ||
| 7 | * Widgets de contenu dynamique, dont les cartes de statistiques GitHub fournies par une instance locale de github-readme-stats. | ||
| 8 | * Configuration modifiable depuis l'interface, enregistrée dans le fichier YAML. | ||
| 9 | |||
| 10 | == Stack == | ||
| 11 | |||
| 12 | {{code language="yaml"}} | ||
| 13 | services: | ||
| 14 | dashy: | ||
| 15 | image: lissy93/dashy:latest | ||
| 16 | container_name: dashy | ||
| 17 | environment: | ||
| 18 | - NODE_ENV=production | ||
| 19 | - UID=1000 | ||
| 20 | - GID=1000 | ||
| 21 | - NODE_TLS_REJECT_UNAUTHORIZED=0 | ||
| 22 | - VUE_APP_BOB=<MOT_DE_PASSE> | ||
| 23 | ports: | ||
| 24 | - "4000:8080" | ||
| 25 | volumes: | ||
| 26 | - <APPDATA>/Dashy/user-data:/app/user-data | ||
| 27 | restart: unless-stopped | ||
| 28 | healthcheck: | ||
| 29 | test: ['CMD', 'node', '/app/services/healthcheck'] | ||
| 30 | interval: 90s | ||
| 31 | timeout: 10s | ||
| 32 | retries: 3 | ||
| 33 | start_period: 40s | ||
| 34 | networks: | ||
| 35 | - proxy | ||
| 36 | |||
| 37 | networks: | ||
| 38 | proxy: | ||
| 39 | external: true | ||
| 40 | {{/code}} | ||
| 41 | |||
| 42 | * ##NODE_TLS_REJECT_UNAUTHORIZED=0## : le serveur de Dashy accepte les certificats non reconnus lors des vérifications d'état, nécessaire pour les services locaux en https avec un certificat auto-signé. | ||
| 43 | * ##VUE_APP_BOB## : mot de passe d'un utilisateur de l'authentification intégrée, référencé par son nom dans ##conf.yml## (##password: VUE_APP_BOB##). Il est lu à la construction de l'application : après modification, reconstruire (Config > Rebuild). | ||
| 44 | |||
| 45 | === Accès === | ||
| 46 | |||
| 47 | * Consultation : publique, sans authentification. | ||
| 48 | * Modification de la configuration depuis l'interface : réservée aux utilisateurs connectés, avec une authentification redirigée vers Authelia. | ||
| 49 | |||
| 50 | {{info}} | ||
| 51 | En consultation publique, le contenu de ##conf.yml## reste lisible par tous : n'y mettre ni mot de passe, ni jeton, ni adresse de service qu'on ne veut pas rendre visible. | ||
| 52 | {{/info}} | ||
| 53 | |||
| 54 | == Configuration == | ||
| 55 | |||
| 56 | Dans ##<APPDATA>/Dashy/user-data## : | ||
| 57 | |||
| 58 | |=Élément|=Rôle | ||
| 59 | |##conf.yml##|Configuration principale : pages, sections, liens, widgets, thème | ||
| 60 | |##bookmark.yml##|Page secondaire de favoris | ||
| 61 | |##item-icons/##|Icônes des services, stockées en local | ||
| 62 | |||
| 63 | * ##appConfig.faviconApi: local## : aucune icône n'est récupérée sur un service externe. | ||
| 64 | * Vérifier la syntaxe après une modification à la main : | ||
| 65 | |||
| 66 | {{code language="bash"}} | ||
| 67 | docker exec dashy yarn validate-config | ||
| 68 | {{/code}} | ||
| 69 | |||
| 70 | == Sauvegarde == | ||
| 71 | |||
| 72 | ##<APPDATA>/Dashy/user-data## est sauvegardé par le script de [[Sauvegarde>>Wiki Batcave John.Infrastructure.Sauvegarde.WebHome]]. Dashy enregistre aussi une copie de la configuration précédente dans ce dossier à chaque sauvegarde depuis l'interface. |