Cómo publicar un sitio de Seed Hypermedia en tu propio sitio web alojado con ionos

2025_01_29 Modificaciones: esta guía fue inicialmente publicada con Mintter en 2024 (antiguo Seed Hypermedia), si estás en Seed Hypermedia ignora las referencias a Mintter porque puedes entenderlas como Seed Hypermedia.

Si estás migrando de un sitio ya publicado en dominio propio de Mintter, tienes que borrar todo el contenido previo de Mintter para hacer la instalación de Seed Hypermedia:

Por ssh tienes que introducir los siguientes comandos:

Comando para borrar Mintter:

docker stop $(docker ps -q) && docker rm $(docker ps -aq) && docker rmi -f $(docker images -q) && docker system prune -af --volumes

Comando para instalar Seed Hypermedia (https://example.com debe ser sustituido por tu dominio o subdominio tal y como se describe en https://github.com/seed-hypermedia/seed:

sh <(curl -sL https://raw.githubusercontent.com/seed-hypermedia/seed/main/website_deployment.sh) https://example.com --auto-update

Tras este comando en la terminal, te devolverá el enlace secreto (descrito en esta guía más adelante), el cual debe introducirse desde la aplicación de Seed Hypermedia desde el desplegable superior derecho que pone "Public to site". En Mintter era "Public group to site".

Si tienes dudas sobre este parrafo de modificaciones, posiblemente tengas que leer la guía antigua para entenderlo:

Introducción

Esta guía sigue los pasos que he realizado para poder publicar un grupo en un dominio propio contratado, no pretendo ser riguroso en los términos empleados pues mis conocimientos son limitados en este campo. Así mismo esta explicación es para ionos ya que los pasos a seguir en otras empresas de hosting/servidores pueden ser distintos.

En el siguiente vídeo se explica como se hace el "Publish Group to Site" en Digital Ocean. Si consigues hacer este proceso en otras empresas de hosting puedes aportar a la comunidad desarrollando tu propia guía en Mintter.

Lo primero es tener una cuenta con ionos. Este paso es simple y lo omitimos.

Primer requisito: tener el dominio contratado.

Adquirir el dominio

Accedes desde el menú a Dominios & SSL:

Una vez contratado el dominio, en la siguiente pestaña haces clic en el nombre de tu dominio

Se te abre la siguiente ventana, en la que tienes que ir a DNS y añadir un registro. En mi caso he filtrado por un subdominio porque es donde quiero realizar la instalación.

Tienes que generar un registro que apunte el dominio/subdominio a la ip del servidor (más adelante se explica como configurar el servidor cloud):

Segundo requisito: contratar el servidor cloud.

Servidor cloud

Elegí un servidor Cloud porque me explicaron que si necesitabas ampliar la capacidad era más sencillo que con un servidor normal. Sobre la siguiente ventana, puedes crear un nuevo servidor Cloud...

O si creas uno por primera vez, te vas a la pagina principal de ionos - Servidores y Cloud - Servidores virtuales - Servidores cloud.

Yo he contratado la versión más básica, que en caso de necesitar ampliarse a futuro no debería haber problemas. En uno de los siguientes pasos de configuración tienes que seleccionar que tenga la instalación sobre ubuntu:

Una vez dentro del panel de tu servidor cloud, yo he llamado al mío Mintter cloud pero le podéis llamar como queráis. A partir de aquí hay algunas cosas más complejas.

Tienes que ir a Red, posteriormente Políticas de firewall, y debes abrir el puerto 56000. Si no, te dará error el último paso de "Public group to site" (me pasó en la instalación). Haz clic en la opción que pone Linux, que viene con los puertos 22, 80 y 443 abiertos de antemano, para poder añadir el 56000.

En la siguiente imagen puedes ver como se crean: todas las ip permitidas, protocolo TCP, puerto 56000 y de comentario le he puesto "para Mintter". Le das a añadir.

Tras esto ya tenemos todo configurado en este segundo requisito. Ahora volvemos a Infraestructura- Servidores y haces clic en el nombre de tu servidor. Te sale la siguiente imagen:

Tachado en naranja está la ip de nuestro servidor, hacia la cual tenemos que dirigir nuestro dominio/subdominio. Nuestro usuario es root y puedes tomar la contraseña para acceder a tu servidor por SSH en esta pestaña. Técnicamente los siguientes pasos los puedes hacer seleccionando en acciones sobre tu servidor -Iniciar consola KVM, o con el programa PuTTY desde tu ordenador.

Enlace para descargar PuTTY: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

En mi caso he usado el terminal de Mac:

Instalación Mintter

Tercer requisito: instalación de curl en el servidor usando el terminal.

Necesitamos instalar curl en el servidor de ubuntu, para ello me he basado en la guía siguiente: https://comandosenlinux.com/ubuntu/como-instalar-curl-en-ubuntu

Abrimos el terminal y ejecutamos:

ssh root@LA.IP.DEL.SERVIDOR

Para alguien familiarizado con el terminal, esto no requiere ser explicado, pero como me dirijo a gente menos experimentada detallo las cosas que un inicio me costaron más por simples que sean. En la siguiente imagen tras introducir el anterior comando, te pide la contraseña del servidor que ya he mencionado previamente como se obtiene. Tienes que pegarla o escribirla, y posteriormente pulsar intro, pero la contraseña en ningún momento la verás en pantalla por lo que es fácil equivocarse.

Una vez dentro podemos instalar curl en nuestro servidor, los comandos son (puedes copiar y pegar en terminal uno a uno):

sudo apt-get update (intro y esperas a que se cargue todo, antes de introducir el siguiente comando).

sudo apt-get update

sudo apt-get install curl (intro y esperas a que se cargue todo, antes de introducir el siguiente comando).

sudo apt-get install curl

curl --version (intro y verás la versión de curl si todo se ha instalado correctamente)

curl --version

Cuarto requisito: instalar el docker de Mintter en el servidor.

Los pasos están descritos en https://github.com/MintterHypermedia/mintter

Continuamos con el terminal y pegamos el siguiente comando, modificando https://example.com por el nombre de nuestro dominio/subdominio:

sh <(curl -sL https://go.hyper.media/website_deployment.sh) https://example.com --auto-update

Esta es la opción para que se realicen las actualizaciones automáticas en nuestro servidor, pero si quieres evitar esto copia el comando sin el "auto-update" del enlace de github. Te recomiendo leer la página de github para entender las opciones.

Si lo has hecho todo bien, terminará la instalación y te saldrá al final del terminal un enlace privado que debes copiar:

Último paso:

Publish group to site

Abrimos la aplicación de Mintter, abrimos el grupo que queremos que salga en nuestro dominio, damos a los tres puntos que aparecen en la esquina superior derecha y pulsamos Publish group to site. Aquí debemos introducir el enlace privado generado en el paso anterior y ya tendremos el grupo vinculado a nuestro dominio.

Con esto ya tendréis vuestro grupo de Mintter en vuestro dominio web propio. Espero que os funcione y haya sido de ayuda la guía.

Activity