This commit is contained in:
Simon Vieille 2023-02-11 14:21:47 +01:00
commit 85338c96d8
Signed by: deblan
GPG key ID: 579388D585F70417
13 changed files with 371 additions and 0 deletions

4
.env Normal file
View file

@ -0,0 +1,4 @@
LIVE_RELOAD_SUPPORT=true
ADD_MODULES=
DOCS_DIRECTORY=/app
FAST_MODE=false

8
Makefile Normal file
View file

@ -0,0 +1,8 @@
serve:
docker run \
-it --rm \
-v $$(pwd):/app \
--env-file ./.env \
-p 8000:8000 \
-w /app \
gitnet.fr/deblan/mkdocs

1
docs/_static/css/extra.css vendored Normal file
View file

@ -0,0 +1 @@

140
docs/_static/img/logo.svg vendored Normal file
View file

@ -0,0 +1,140 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
width="57.044163mm"
height="57.044163mm"
viewBox="0 0 57.044163 57.044163"
version="1.1"
id="svg1433"
inkscape:version="1.0.2 (e86c870879, 2021-01-15)"
sodipodi:docname="logo.svg">
<defs
id="defs1427" />
<sodipodi:namedview
id="base"
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1.0"
inkscape:pageopacity="0.0"
inkscape:pageshadow="2"
inkscape:zoom="1.979899"
inkscape:cx="321.98969"
inkscape:cy="157.98647"
inkscape:document-units="mm"
inkscape:current-layer="layer1"
inkscape:document-rotation="0"
showgrid="false"
fit-margin-top="0"
fit-margin-left="0"
fit-margin-right="0"
fit-margin-bottom="0"
inkscape:window-width="1918"
inkscape:window-height="1021"
inkscape:window-x="0"
inkscape:window-y="38"
inkscape:window-maximized="1" />
<metadata
id="metadata1430">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title></dc:title>
</cc:Work>
</rdf:RDF>
</metadata>
<g
inkscape:label="Calque 1"
inkscape:groupmode="layer"
id="layer1"
transform="translate(28.522081,-55.38863)">
<rect
inkscape:export-ydpi="39.689999"
inkscape:export-xdpi="39.689999"
y="56.07637"
x="-27.834341"
height="55.668682"
width="55.668682"
id="rect4634-3"
style="color:#000000;display:inline;overflow:visible;visibility:visible;vector-effect:none;fill:#e7e7e9;fill-opacity:1;fill-rule:nonzero;stroke:#cacaca;stroke-width:1.37548;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:0.23561995;marker:none;enable-background:accumulate"
rx="13.495078"
ry="13.495078" />
<g
id="g1407"
transform="matrix(2.0273259,0,0,2.0273259,-27.344561,-1105.4865)">
<g
transform="matrix(4.4401232,0,0,4.4401232,-808.26617,111.24909)"
style="fill:#333333;stroke-width:0.36558"
id="g6075-3-5-5-5">
<rect
style="color:#000000;display:inline;overflow:visible;visibility:visible;fill:#333333;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:0.0106793;marker:none;enable-background:accumulate"
id="rect22527-2-9-55-1-9-8-6-6-6"
width="1.1607833"
height="1.1635288"
x="183.11276"
y="107.87968"
rx="0.19624296"
ry="0.1967071"
inkscape:export-filename="/home/simon/obs/img/title.png"
inkscape:export-xdpi="90"
inkscape:export-ydpi="90" />
<rect
style="color:#000000;display:inline;overflow:visible;visibility:visible;fill:#333333;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:0.0106793;marker:none;enable-background:accumulate"
id="rect22527-2-9-5-2-6-2-0-2-2-2"
width="1.1607833"
height="1.1635288"
x="184.49425"
y="107.87968"
rx="0.19624296"
ry="0.1967071"
inkscape:export-filename="/home/simon/obs/img/title.png"
inkscape:export-xdpi="90"
inkscape:export-ydpi="90" />
<rect
style="color:#000000;display:inline;overflow:visible;visibility:visible;fill:#333333;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:0.0106793;marker:none;enable-background:accumulate"
id="rect22527-2-9-9-8-7-2-4-9-9-9"
width="1.1607833"
height="1.1635288"
x="185.87572"
y="107.87968"
rx="0.19624296"
ry="0.1967071"
inkscape:export-filename="/home/simon/obs/img/title.png"
inkscape:export-xdpi="90"
inkscape:export-ydpi="90" />
<rect
style="color:#000000;display:inline;overflow:visible;visibility:visible;fill:#333333;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:0.0106793;marker:none;enable-background:accumulate"
id="rect22527-2-9-8-6-4-8-7-1-1-1"
width="1.1607833"
height="1.1635288"
x="185.87572"
y="106.49491"
rx="0.19624296"
ry="0.1967071"
inkscape:export-filename="/home/simon/obs/img/title.png"
inkscape:export-xdpi="90"
inkscape:export-ydpi="90" />
<rect
style="color:#000000;display:inline;overflow:visible;visibility:visible;fill:#333333;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:0.0106793;marker:none;enable-background:accumulate"
id="rect22527-2-7-7-9-68-27-2-2"
width="1.1607833"
height="1.1635288"
x="184.49425"
y="105.11017"
rx="0.19624296"
ry="0.1967071"
inkscape:export-filename="/home/simon/obs/img/title.png"
inkscape:export-xdpi="90"
inkscape:export-ydpi="90" />
</g>
</g>
</g>
</svg>

After

Width:  |  Height:  |  Size: 5.4 KiB

49
docs/hosting/access.md Normal file
View file

@ -0,0 +1,49 @@
# Accès
## WEB
Des accès uniques seront créés sur demande pour chaque application qui devra être hébergée.
Les technologies et leurs configurations doivent passer par une demande via e-mail.
### Administration de votre base de données
* [Mariadb] Accès à phpMyAdmin : [https://phpmyadmin.deblan.org/](https://phpmyadmin.deblan.org/)
* [Mariadb] Accès à Adminer : [https://adminer.deblan.org/](https://adminer.deblan.org/)
* [PostgreSQL] Accès à phpPgAdmin : [hhttps://phppgadmin.deblan.org/](https://phppgadmin.deblan.org/)
## E-MAIL
Pour activer votre boite mail, lancer la commande suivante : `$ maildirmake Maildir`
### Webmails :
* RainLoop ([https://webmail2.deblan.org/](https://webmail2.deblan.org/)). Votre identifiant est sous la forme : "utilisateur@exemple.fr". Votre mot de passe est identique à celui de votre compte SSH.
* RoundCube ([https://webmail.deblan.org/](https://webmail.deblan.org/)). Votre identifiant est sous la forme : "utilisateur@exemple.fr". Votre mot de passe est identique à celui de votre compte SSH. Ne fonctionne que pour les mails hébergés sur mon serveur.
Création d'alias sur demande (uniquement si vous avez un domaine à vous).
### Paramètres pour lire et envoyer le courrier :
* IMAP : mail.deblan.org:993 (TLS/SSL)
* SMTP : mail.deblan.org:587 (STARTTLS)
Authentification nécessaire depuis l'extérieur du réseau DEBLAN. Même identifiants que l'accès SSH (vous/mot de passe).
## Lecteur RSS
Une instance Tiny Tiny RSS est installée. Création de compte possible via une demande par e-mail.
## Cloud fichiers/CalDAV/CardDAV
Une instance Nextcloud est installée. Création de compte possible via une demande par e-mail. Un lien vers la page d'inscription vous sera alors transmis puis le compte sera validé. 1Go d'espace disque maximum.
Compatible avec Microsoft Windows, MacOS et sur beaucoup de distributions Linux. Fonctionne également avec Android et IOs.
## Git
Une instance gogs est installée. Vous pouvez librement créer un compte sur [https://gitnet.fr/](https://gitnet.fr)
## IRC
Deblan fait partie du réseau NeutralIRC. Son instance NeutralNetwork est libre d'accès. https://ssl.neutralnetwork.org/

17
docs/hosting/cgu.md Normal file
View file

@ -0,0 +1,17 @@
# Conditions générales d'utilisation
En utilisant les services mis à disposition par Simon Vieille, vous acceptez de respecter l'ensemble des lois Française en vigueur.
1. Simon Vieille décline toute responsabilité sur les contenus que vous mettez en ligne.
2. Il n'y a aucune garantie sur l'accessibilité et la continuité des services.
3. Toutes les demandes doivent passer par un e-mail. Aucune garantie sur le temps de réponse.
4. Vous vous engagez à n'utilisez que des logiciels libres.
5. Vous vous engagez à faire les mises à jour de sécurité de vos applications.
6. Vous vous engagez à utiliser les services de manière raisonnable (espace disque, bande passante, trafic, etc.).
7. Vous respecterez la vie privée des autres utilisateurs. Simon Vieille s'engage à respecter la vôtre. Vos contenus font partie de votre vie privée.
8. En cas de perte de données ou piratage, Simon Vieille décline toute responsabilité. Il mettra cependant tout en œuvre pour récupérer un backup le plus récent possible.
9. Vous ne partagez pas vos accès/identifiants vers les services/le serveur.
10. Vous avez moins de 16 ans, en application du RGPD (Règlement Général sur la Protection des Données), vous ne pouvez pas bénéficier des services qui impliquent une inscription.
11. Simon Vieille se réserve le droit, à tout moment de modifier ou dinterrompre, temporairement ou définitivement, le service avec ou sans préavis.
12. Simon Vieille ne sera pas responsable envers vous ou tout tiers pour toute modification, suspension ou interruption du service.
</markdown>

7
docs/hosting/overview.md Normal file
View file

@ -0,0 +1,7 @@
# Deblan Hosting
Je suis [membre](https://chatons.org/fr/chaton/simon-vieille) du *Collectif des Hébergeurs Alternatifs,Transparents, Ouverts, Neutres et Solidaires* : **[Chatons.org](https://chatons.org/)**.
Ce collectif rassemble des structures souhaitant **éviter la collecte et la centralisation des données personnelles**
au sein de silos numériques du type de ceux proposés par les GAFAM (Google, Apple, Facebook, Amazon, Microsoft).
Ainsi, je propose de partager mon serveur auto-hébergé depuis une dizaine d'années.

71
docs/hosting/services.md Normal file
View file

@ -0,0 +1,71 @@
# Services
## Offre
Elle est assez similaire à ce que vous pourriez trouver plus ou moins gratuitement :
* Un serveur web configuré aux petits oignons
* Frontend NGINX avec cache des assets (proxy sur demande)
* Backend Apache2
* PHP 7.* (FPM), autres langages sur demande [1]
* Mariadb 10.1, PostgreSQL 9.4, 9.6 et 11
* Un espace de stockage fonction de l'espace disque disponible
* Système de backup
[1] Selon mes critères de sécurité
### Accès au serveur
* Accès SSH avec shell ZSH par défaut
* SFTP
### Les plus
* Un sous-domaine `votre-projet.deblan.org` ou `votre-projet.deblan.fr` (HTTP et HTTPS)
* Possibilité d'utiliser un domaine à vous [2] (HTTP et HTTPS via [letsencrypt] ou votre certificat)
* Un serveur de mail :
* une adresse mail `@deblan.fr` (+ un 1 alias si besoin)
* possibilité d'utiliser votre nom de domaine ou un sous-domaine de deblan en mode alias :
* `@votre-domaine` alias de `vous@deblan.fr` [2]
* ou `@votre-projet.deblan.fr` alias de `vous@deblan.fr`
* ou `@votre-projet.deblan.org` alias de `vous@deblan.fr`
* [Webmail] [webmail]
* [Statistiques Umami] [umami]
* [Serveur GIT disponible] [gitnet] (Gitea)
* [Instance Tiny Tiny RSS] [tiny]
* [Instance NextCloud] [nextcloud]
* Serveur IRC disponible
Voir tous les [services](/doku.php/services).
[2] Cela nécessite de configurer les DNS de votre nom de domaine
### Infrastructure
* Derrière une ligne VDSL2 chez Free (80Mb/s descendant, 20Mb/s montant)
* Core i5, 16Go de RAM ECC, système Debian GNU/Linux 9
* Système et bases de données sur SSD
* Data sur HDisk
* Aucun panel : je réalise l'ensemble des configurations
### À qui est destinée l'offre ?
__Tout le monde peut bénéficier de cette offre__. Cependant, je privilégie les projets dont l'objectif est de promouvoir le logiciel libre,
par quelque moyen que ce soit, les personnes avec des revenus ne permettant pas l'accès à l'hébergement facile et enfin les étudiants.
Pour accéder aux services qui nécessitent une inscription (hébergement web et les [autres services concernés](/doku.php/services)), il faut faire une demande en me contactant via [ce formulaire](https://hebergement.deblan.org/) ou depuis [mon blog](https://www.deblan.io/contact). Prenez le temps d'expliquer votre projet et vos besoins :)
Les termes étoilés indiquent que ce sont des services non délivrés par défaut. J'analyse le coût et accepte ou pas la demande.
[gitnet]: https://gitnet.fr/
[umami]: https://umami.deblan.org/
[tiny]: https://tiny.deblan.org/
[webmail]: https://webmail2.deblan.org/
[nextcloud]: https://cloud.deblan.org/
[letsencrypt]: https://letsencrypt.org/
## Conditions générales d'utilisation
[Les CGU](/doku.php/service-hebergement/cgu) doivent être lues et acceptées pour bénéficier d'un ou plusieurs des services proposés.
Cet engagement sera fera par e-mail si la demande est réalisée depuis le formulaire de contact de mon blog ou via une case à cocher si la demande est réalisée depuis hebergement.deblan.org.
</markdown>

View file

@ -0,0 +1,6 @@
Nom;Description;URL;Code source
Tiny Tiny RSS;Agrégateur de flux RSS;https://tiny.deblan.org/;https://git.tt-rss.org/git/tt-rss
NextCloud;Gestion de fichiers collaborative, calendriers, contacts, mots de passe;https://deblan.cloud/;https://github.com/nextcloud/server
Wallabag;Outils pour gérer ses lectures différées;https://wallabag.deblan.org/;https://github.com/wallabag/wallabag
RoundCube;Webmail;https://webmail.deblan.org/;https://github.com/roundcube/roundcubemail
RainLoop;Webmail;https://webmail2.deblan.org/;https://github.com/rainloop/rainloop-webmail
1 Nom Description URL Code source
2 Tiny Tiny RSS Agrégateur de flux RSS https://tiny.deblan.org/ https://git.tt-rss.org/git/tt-rss
3 NextCloud Gestion de fichiers collaborative, calendriers, contacts, mots de passe https://deblan.cloud/ https://github.com/nextcloud/server
4 Wallabag Outils pour gérer ses lectures différées https://wallabag.deblan.org/ https://github.com/wallabag/wallabag
5 RoundCube Webmail https://webmail.deblan.org/ https://github.com/roundcube/roundcubemail
6 RainLoop Webmail https://webmail2.deblan.org/ https://github.com/rainloop/rainloop-webmail

3
docs/services/private.md Normal file
View file

@ -0,0 +1,3 @@
# Services accessibles sur inscription
{{ read_csv('services/private.csv') }}

12
docs/services/public.csv Normal file
View file

@ -0,0 +1,12 @@
Nom;Description;URL;Code source
Gitnet;Forge logicielle GIT;https://gitnet.fr;https://github.com/go-gitea/gitea
OG:Image;Générateur d'image pour le partage sur les réseaux;https://deblan.gitnet.page/og-image;https://gitnet.fr/deblan/og-image
Sondage;Organiser des rendez-vous simplement;https://sondage.deblan.org/;https://framagit.org/framasoft/framadate/framadate
Cyberchef;Application de cryptographie, de compression et d'analyse/traitement de données;https://cyberchef.deblan.org/;https://github.com/gchq/CyberChef
SVGOMG;Optimisation de fichiers SVG;https://svg.deblan.org/;https://gitnet.fr/deblan/svgomg-ui https://github.com/jakearchibald/svgomg
PrivateBin;Partage de contenus textes chiffrés;https://privatebin.deblan.org;https://github.com/PrivateBin/PrivateBin
Pad;Édition collaborative de texte;https://pad.deblan.org/;https://github.com/ether/etherpad-lite
Calc;Édition collaborative de tableau;https://calc.deblan.org/;https://github.com/audreyt/ethercalc
LibreQR;Générateur de Qrcode;https://code.antopie.org/miraty/libreqr/
Drawio;Éditeur de diagrammes;https://draw.deblan.org/;https://github.com/jgraph/drawio
Image Scrubber;Anonymisation de photos (suppression des données exif et floutage
1 Nom;Description;URL;Code source
2 Gitnet;Forge logicielle GIT;https://gitnet.fr;https://github.com/go-gitea/gitea
3 OG:Image;Générateur d'image pour le partage sur les réseaux;https://deblan.gitnet.page/og-image;https://gitnet.fr/deblan/og-image
4 Sondage;Organiser des rendez-vous simplement;https://sondage.deblan.org/;https://framagit.org/framasoft/framadate/framadate
5 Cyberchef;Application de cryptographie, de compression et d'analyse/traitement de données;https://cyberchef.deblan.org/;https://github.com/gchq/CyberChef
6 SVGOMG;Optimisation de fichiers SVG;https://svg.deblan.org/;https://gitnet.fr/deblan/svgomg-ui https://github.com/jakearchibald/svgomg
7 PrivateBin;Partage de contenus textes chiffrés;https://privatebin.deblan.org;https://github.com/PrivateBin/PrivateBin
8 Pad;Édition collaborative de texte;https://pad.deblan.org/;https://github.com/ether/etherpad-lite
9 Calc;Édition collaborative de tableau;https://calc.deblan.org/;https://github.com/audreyt/ethercalc
10 LibreQR;Générateur de Qrcode;https://code.antopie.org/miraty/libreqr/
11 Drawio;Éditeur de diagrammes;https://draw.deblan.org/;https://github.com/jgraph/drawio
12 Image Scrubber;Anonymisation de photos (suppression des données exif et floutage

3
docs/services/public.md Normal file
View file

@ -0,0 +1,3 @@
# Services accessibles librement
{{ read_csv('services/public.csv') }}

50
mkdocs.yml Normal file
View file

@ -0,0 +1,50 @@
site_name: Deblan Wiki
# extra_css:
# - /_static/css/extra.css
plugins:
- search
- table-reader
- git-revision-date-localized
theme:
name: material
logo: /_static/img/logo.svg
favicon: /_static/img/logo.svg
features:
- content.code.copy
palette:
- scheme: default
toggle:
icon: material/brightness-7
name: Switch to dark mode
- scheme: slate
toggle:
icon: material/brightness-4
name: Switch to light mode
markdown_extensions:
- pymdownx.highlight:
anchor_linenums: true
extend_pygments_lang:
- name: php-inline
lang: php
options:
startinline: true
- pymdownx.tabbed:
alternate_style: true
- pymdownx.snippets
- pymdownx.superfences
- pymdownx.highlight
- pymdownx.inlinehilite
nav:
- "Service d'hébergement":
- "Deblan Hosting": hosting/overview.md
- "Services": hosting/services.md
- "Accès": hosting/access.md
- "Conditions générales d'utilisation": hosting/cgu.md
- "Services":
- "Accès libre": services/public.md
- "Sur inscription": services/private.md