Cómo Auto-Hostear BookStack en un VPS (Guía Completa)

BookStack es una plataforma simple y auto-hosted para organizar y almacenar documentación. Si eres un desarrollador o un homelabber que busca auto-hostear BookStack en un VPS, esta guía te llevará a través del proceso de instalación paso a paso. Exploraremos la instalación utilizando Docker, lo que simplifica la implementación y gestión de aplicaciones.

¿Por qué Usar BookStack?

BookStack te permite crear documentación al estilo wiki de manera sencilla, con características como:

• Páginas anidadas
• Soporte para Markdown
• Roles y permisos de usuario
• Capacidades de búsqueda integradas

Esto hace que BookStack sea una elección ideal para cualquiera que busque construir y mantener documentación para proyectos o uso personal.

Elegir un Proveedor de VPS

Hay varios proveedores de VPS para elegir según tu presupuesto y requisitos. A continuación, se presenta una comparación rápida de proveedores populares:

Al seleccionar un proveedor de VPS, considera factores como precios, rendimiento y facilidad de uso. Si no estás seguro, consulta nuestra comparación completa de VPS para más opciones.

Preparando Tu VPS

1. Implementa Tu VPS: Elige un proveedor de la tabla y configura tu VPS. Selecciona tu distribución de Linux preferida (se recomienda Ubuntu/Debian).

2. Accede a Tu Servidor: Utiliza SSH para conectarte a tu servidor. Puedes usar una aplicación de terminal como PuTTY o la terminal de tu sistema.

   ssh nombre_usuario@tu_ip_vps

3. Actualiza Tu Sistema: Siempre mantén tu sistema actualizado.

   sudo apt update && sudo apt upgrade -y

Instalando Docker

BookStack se puede ejecutar fácilmente utilizando Docker. Instala Docker ejecutando los siguientes comandos:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y

Puedes verificar la instalación comprobando la versión de Docker:

docker --version

Instalando Docker Compose

Docker Compose es una herramienta para definir y ejecutar aplicaciones Docker de múltiples contenedores. Instala Docker Compose con los siguientes comandos:

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Verifica que Docker Compose esté instalado:

docker-compose --version

Desplegando BookStack

1. Crea un Directorio para BookStack:

   mkdir ~/bookstack
   cd ~/bookstack

2. Crea un Archivo docker-compose.yml:

   Usa tu editor de texto preferido para crear el archivo:

   nano docker-compose.yml

   Añade la siguiente configuración:

   version: '2'
   services:
     bookstack:
       image: solidnerd/bookstack
       ports:
         - "80:80"
       environment:
         - DB_HOST=db
         - DB_USER=bookstack
         - DB_PASS=bookstackpassword
         - DB_DATABASE=bookstack
       depends_on:
         - db
   
     db:
       image: mysql:5.7
       environment:
         - MYSQL_ROOT_PASSWORD=rootpassword
         - MYSQL_DATABASE=bookstack
         - MYSQL_USER=bookstack
         - MYSQL_PASSWORD=bookstackpassword
       volumes:
         - db_data:/var/lib/mysql
   
   volumes:
     db_data:

   Modifica las contraseñas de la base de datos según sea necesario.

3. Inicia los Contenedores:

   Ejecuta el siguiente comando para iniciar BookStack:

   docker-compose up -d

   Este comando descargará las imágenes necesarias y las iniciará en modo desacoplado.

4. Accede a BookStack:

   Abre tu navegador web y ve a http://tu_ip_vps. Deberías ver la página de configuración de BookStack. Sigue las instrucciones en pantalla para finalizar la instalación.

Gestionando BookStack

Puedes gestionar BookStack a través de la interfaz web. Puedes agregar usuarios, crear diferentes libros, capítulos y páginas según tus necesidades.

Preguntas Frecuentes

Q1: ¿Puedo ejecutar BookStack sin Docker?

Sí, puedes instalar BookStack sin Docker, pero requiere una configuración manual más extensa, incluyendo la configuración de PHP, MariaDB, y un servidor web como Apache o Nginx. Docker simplifica el proceso significativamente, permitiendo una implementación y actualizaciones más fáciles.

Q2: ¿Cómo hago una copia de seguridad de mi instalación de BookStack?

Para hacer una copia de seguridad de tu instalación de BookStack, necesitarás hacer una copia de seguridad tanto de la base de datos como de los archivos de la aplicación. Puedes lograr esto utilizando comandos de Docker para copiar los archivos de la base de datos y guardar los datos de tu directorio de BookStack. Automatizar esto a través de scripts puede agilizar aún más el proceso de copia de seguridad.

Q3: ¿Es BookStack seguro para auto-hosting?

BookStack es relativamente seguro, especialmente cuando se auto-hostea. Es crucial usar contraseñas fuertes, mantener el software actualizado y configurar reglas de firewall apropiadas. Además, el uso de SSL (a través de Let’s Encrypt o similar) ayuda a garantizar un acceso seguro a tu instancia de BookStack a través de la web.

Conclusión

Auto-hostear BookStack en un VPS proporciona una forma poderosa de gestionar tus necesidades de documentación. Con los pasos delineados en esta guía, puedes implementar y gestionar eficientemente tu propia instancia de BookStack. No olvides explorar las diversas características de BookStack y personalizarlo para satisfacer tus requisitos a medida que amplías tu base de conocimientos. Para otras opciones y comparaciones de proveedores de VPS, echa un vistazo a nuestra comparación completa de VPS. ¡Feliz hosting!