💾 Archived View for michan.es › tutoriales › howto.gmi captured on 2024-02-05 at 09:21:25. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2023-04-19)
-=-=-=-=-=-=-
ATENCIÖN: Este tutorial está desactualizado y es posible que ya no sea correcto. En la actualidad recomiendo usar agate.
Hay varios servidores y clientes para gemini, recopilados en
gemini://gemini.circumlunar.space/software/
Pero por simplicidad y por afinidad recomiendo usar gmnisrv, un servidor de gemini creado por Drew DeVault
https://git.sr.ht/~sircmpwn/gmnisrv
En ese enlace tenéis las instrucciones, y si usáis Arch Linux podéis instalarlo desde el AUR (gmnisrv-git), pero reproduzco las instrucciones también a continuación:
git clone https://git.sr.ht/~sircmpwn/gmnisrv
cd gmnisrv
mkdir build
cd build
../configure --prefix=/usr
make
sudo make install
La instalación con make install no es estrictamente necesaria, podéis usar el binario tal cual, pero es recomendable. Si estáis en Debian/Ubuntu tal vez tengáis que instalar "libssl-dev" primero, si no está instalado.
Antes de arrancar el servidor gemini, debéis configurarlo un poco. Primero, copiad la configuración base, y abrirla con vuestro editor:
sudo cp /usr/share/gmnisrv/gmnisrv.ini /etc/gmnisrv.ini
sudo $EDITOR /etc/gmnisrv.ini
En principio basta con cambiar "user" por vuestro nick en la línea de "organization". El resto de ajustes no hace falta tocarlos para conectarse desde la propia máquina. Si deseamos conectarnos desde el exterior, tendremos que añadir nuestro dominio como una nueva sección:
[tudominio.com]
root=/srv/gemini
Si deseáis conectar desde el exterior recordad abrir el puerto 1965 (o cualquier otro que hayamos escogido). Para más opciones de configuración consultad la página del manual con:
man gmnisrv.ini
Con esto ya podemos iniciar el servidor y... ¡No, espera! ¡Falta lo más importante!
Como has podido adivinar las páginas gemini se guardan por defecto en /srv/gemini. Primero, crea la carpeta:
sudo mkdir /srv/gemini
A continuación vamos a crear una página index.gmi, que es la página que se muestra por defecto cuando accedemos al servidor gemini:
sudo $EDITOR /srv/gemini/index.gmi
Si necesitas ayuda con la sintaxis de gemini, consulta el siguiente enlace:
gemini://gemini.circumlunar.space/docs/specification.gmi
Una vez listos, podemos iniciar nuestro servidor. Como es la primera vez, puede que tarde un poco en generar el certificado:
sudo gmnisrv
¡Y ya está! Si habéis montado el servidor en local, podéis acceder a él usando un cliente gemini en vuestro ordenador. Por ejemplo, gmni, también de Drew DeVault
https://git.sr.ht/~sircmpwn/gmni
gmni -j once gemini://localhost
¡A disfrutar de gemini!