💾 Archived View for g.erreur503.xyz › install_agate.gmi captured on 2023-01-29 at 02:15:23. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

Installer une capsule Gemini avec agate, sous Debian

Très beaucoup inspiré de la procédure de Zorglub et de la doc officielle.

Installer un serveur agate - gemini.alterzorg.fr

Github de agate

Rien de très compliqué, je suis un très mauvais admin sys donc j'ai été au plus simple. Pas de Docker, pas de vhost ou de frivolités. Juste un exécutable lancé au démarrage via systemd. C'est même exécuté en root. Ne faites pas ça, sérieusement.

Disclaimer : je ne me suis quasiment pas relu, il y a sûrement des fautes. Faisez gaffe !

Pré-requis

Un cerveau vaguement fonctionnel
Des notions basique d'utilisation de GNU/Linux
L'envie d'utiliser Gemini. Enfin, si vous êtes ici c'est que vous y avez déjà mit le pied.

Télécharger agate

Se rendre sur la page de téléchargement du serveur agate, un petit serveur Gemini développé en Rust.

Github de agate.

Télécharger le fichier agate.x86_64-unknown-linux-gnu.gz avec un coup de wget.

Décompresser avec la commande suivante :

gunzip agate.x86_64-unknown-linux-gnu.gz

Préparer l'environnement

Pour s'y retrouver on va crééer une arboresence de dossiers :

mkdir agate/bin
mkdir agate/certs
mkdir agate/content

Remarque : chez moi l'exécutable et les certificats sont dans /root/agate, par contre mon contenu est dans /var/gemini.

On déplace l'exécutable dans bin

mv agate.x86_64-unknown-linux-gnu agate/bin/agate.x86_64-unknown-linux-gnu

On va maintenant générer les certificats kivonbien :

openssl req -x509 -newkey rsa:4096 -keyout agate/certs/key.rsa -out agate/certs/cert.pem -days 3650 -nodes -subj "/CN=TON.DOMAINE.PROUT"

Remplacez TON.DOMAIN.PROUT par votre domaine. Soyez pas con, hein, quand même.

Tester

Comme on est des p'tits fifious, on va tester quand même. Lancez la commande suivante :

./agate/bin/agate.x86_64-unknown-linux-gnu --content agate/content --key agate/certs/key.rsa --cert agate/certs/cert.pem --hostname TON.DOMAINE.PROUT --lang fr-FR

Crééez une pages index.gmi contenant ce que vous voulez dans le dossier du contenu. En vous connectant avec un navigateur ad-hoc sur votre capsule Gemini, la page devrait apparaitre.

Créer un service agate

Parce qu'on est des feignasses on va créer un service systemd.

Créer /etc/systemd/system/agate.service :

[Unit]
Description=agate
After=network.target

[Service]
User=USER (root chez moi, c'est mal, faisez pas ça)
Type=simple
ExecStart=/OU/EST/agate/bin/agate.x86_64-unknown-linux-gnu -s --content /OU/EST/agate/content/ --key /OU/EST/agate/certs/key.rsa --cert /OU/EST/agate/certs/cert.pem --hostname MON.DOMAINE.PROUT --lang fr-FR

[Install]
WantedBy=default.target

Démarrez le service :

systemctl start agate
systemctl enable agate

Profit

Profitez du swag offert par votre Capsule Gemini pour vous la péter auprès de tous vos potes geeks 🤓.