Despliegue de Baserow

Configuración

Después de iniciar Baserow con Docker Compose con éxito, es necesario realizar la configuración final para garantizar un acceso seguro y conveniente. Esto incluye la configuración del nombre de dominio, HTTPS y parámetros adicionales.

1. Configuración de DNS

Para acceder a Baserow por nombre de dominio (por ejemplo, baserow.yourdomain.com), debe crear un registro A en su registrador de nombres de dominio. Especifique su dominio (o subdominio) y la dirección IP de su VPS.

# Ejemplo de registro en su registrador de dominio
Type: A
Host: baserow
Value: SU_DIRECCIÓN_IP_VPS

Espere a que se actualicen los registros DNS (puede tardar desde unos minutos hasta varias horas).

2. Configuración de Caddy para HTTPS

Baserow Docker Compose incluye por defecto el servicio Caddy, que actúa como proxy inverso y gestiona automáticamente los certificados Let's Encrypt para HTTPS. La configuración se realiza a través del archivo Caddyfile.

Por defecto, el archivo Caddyfile ya está configurado en el directorio baserow/caddy. Asegúrese de que en su docker-compose.yml el archivo Caddyfile esté montado en el contenedor Caddy:

# Contenido de docker-compose.yml (fragmento para Caddy)
# ...
  caddy:
    image: caddy:2.7.6-alpine # Versión actual de Caddy para 2026
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./caddy/Caddyfile:/etc/caddy/Caddyfile:ro
      - baserow_caddy_data:/data
      - baserow_caddy_config:/config
    depends_on:
      - baserow_web
# ...

Cree el directorio caddy y el archivo Caddyfile dentro de él, si no existen:

mkdir caddy
nano caddy/Caddyfile

Añada o asegúrese de que caddy/Caddyfile contenga lo siguiente (reemplace baserow.yourdomain.com por su dominio):

{
  # Reemplace con su email para notificaciones de Let's Encrypt
  email [email protected]
}

baserow.yourdomain.com {
  reverse_proxy baserow_web:80
}

Después de editar el archivo Caddyfile, si lo ha modificado, es necesario reiniciar solo el servicio Caddy:

docker compose restart caddy # Reinicio del contenedor Caddy

Caddy detectará automáticamente el nuevo dominio, solicitará un certificado Let's Encrypt y configurará HTTPS. Si encuentra problemas, revise los registros de Caddy:

docker compose logs caddy # Visualización de los registros de Caddy

3. Verificación de la operatividad

Después de configurar DNS y Caddy, verifique la disponibilidad de Baserow:

• Disponibilidad del sitio: Abra su dominio (https://baserow.yourdomain.com) en el navegador. Debería ver la página de registro/inicio de sesión de Baserow.
• Verificación HTTPS: Asegúrese de que la conexión esté protegida (candado verde en la barra de direcciones).
• Ping del dominio: Verifique que el dominio se resuelva a la dirección IP correcta.

ping baserow.yourdomain.com

• Comprobación de salud de los contenedores: Asegúrese de que todos los contenedores Docker funcionen sin errores.

docker compose ps
docker compose logs

Si Baserow se carga, puede registrar al primer usuario (administrador) y comenzar a trabajar con la plataforma.

4. Configuraciones adicionales en .env (si es necesario)

El archivo .env contiene muchas otras configuraciones que pueden ser útiles en el futuro:

• BASEROW_EMAIL_SMTP_HOST, BASEROW_EMAIL_SMTP_PORT, etc.: Configuración del servidor SMTP para el envío de correo electrónico (notificaciones, restablecimiento de contraseña).
• BASEROW_PUBLIC_BACKEND_URL: Si utiliza un backend separado, diferente del dominio principal.
• MEDIA_ROOT: Ruta para almacenar archivos de usuario. Por defecto, es un volumen de Docker.

Consulte siempre la documentación oficial de Baserow para obtener una lista completa y la descripción de todas las variables de entorno.

Importante: Nunca almacene datos confidenciales (contraseñas, claves API) directamente en el código o en archivos de acceso público. El archivo .env debe estar protegido y no debe incluirse en sistemas de control de versiones.

Copias de seguridad y mantenimiento

Las copias de seguridad regulares y el mantenimiento oportuno son críticos para cualquier sistema en producción. Esto garantiza la seguridad de sus datos y la estabilidad del funcionamiento de Baserow.

1. Qué respaldar

Para Baserow, es necesario respaldar los siguientes componentes:

• Base de datos PostgreSQL: Contiene todos los datos estructurados creados en Baserow. Este es el componente más importante.
• Archivos de usuario (medios): Todos los archivos subidos por los usuarios a Baserow (imágenes, documentos, etc.). Se almacenan en el volumen de Docker asociado al servicio baserow_backend.
• Archivos de configuración: docker-compose.yml y .env. Contienen la configuración de despliegue y las claves secretas necesarias para restaurar el sistema.

2. Script simple de copia de seguridad automática

Crearemos un script simple para la copia de seguridad automática. Este script volcará la base de datos, archivará los archivos multimedia y guardará los archivos de configuración. Se asume que usted se encuentra en el directorio ~/baserow.

mkdir -p ~/baserow_backups # Creación del directorio para las copias de seguridad
nano ~/baserow_backups/backup_baserow.sh

Agregue el siguiente contenido al archivo backup_baserow.sh. Reemplace YOUR_DB_USER y YOUR_DB_PASSWORD con los valores de su archivo .env:

#!/bin/bash

# Configuración
BACKUP_DIR="/home/baserow_admin/baserow_backups" # Directorio para almacenar las copias de seguridad
BASEROW_DIR="/home/baserow_admin/baserow"       # Directorio donde se encuentra docker-compose.yml
TIMESTAMP=$(date +%Y%m%d_%H%M%S)

# Variables de .env (necesarias para pg_dump)
# Se pueden leer de .env o establecer manualmente
# Ejemplo de lectura de .env (requiere jq, que se puede instalar: sudo apt install jq -y)
# source "$BASEROW_DIR/.env" # Si .env es simple, sin caracteres especiales

# O establecer manualmente si .env tiene caracteres complejos o no se desea parsear
DB_NAME="baserow"
DB_USER="baserow"
DB_PASSWORD="YOUR_STRONG_DATABASE_PASSWORD_HERE" # Reemplace con la contraseña real de .env

# 1. Copia de seguridad de la base de datos PostgreSQL
echo "Dumping PostgreSQL database..."
docker compose -f "$BASEROW_DIR/docker-compose.yml" exec -T database pg_dump -U "$DB_USER" -d "$DB_NAME" > "$BACKUP_DIR/baserow_db_${TIMESTAMP}.sql"
if [ $? -eq 0 ]; then
    echo "Volcado de base de datos exitoso: $BACKUP_DIR/baserow_db_${TIMESTAMP}.sql"
else
    echo "¡Volcado de base de datos FALLIDO!"
    exit 1
fi

# 2. Copia de seguridad de archivos multimedia (volumen Docker)
echo "Archivando archivos multimedia de Baserow..."
# Obtenemos el nombre del volumen para los archivos multimedia
MEDIA_VOLUME=$(docker volume ls -q | grep baserow_data) # Se asume que el nombre del volumen contiene 'baserow_data'
if [ -z "$MEDIA_VOLUME" ]; then
    echo "No se pudo encontrar el volumen de medios de Baserow. Omitiendo la copia de seguridad de medios."
else
    # Creamos un contenedor temporal para copiar datos
    docker run --rm -v "$MEDIA_VOLUME":/data -v "$BACKUP_DIR":/backup_dest alpine tar -czvf "/backup_dest/baserow_media_${TIMESTAMP}.tar.gz" -C /data .
    if [ $? -eq 0 ]; then
        echo "Archivo de archivos multimedia exitoso: $BACKUP_DIR/baserow_media_${TIMESTAMP}.tar.gz"
    else
        echo "¡Archivo de archivos multimedia FALLIDO!"
    fi
fi

# 3. Copia de archivos de configuración
echo "Copiando archivos de configuración..."
cp "$BASEROW_DIR/docker-compose.yml" "$BACKUP_DIR/docker-compose_${TIMESTAMP}.yml"
cp "$BASEROW_DIR/.env" "$BACKUP_DIR/.env_${TIMESTAMP}"
echo "Archivos de configuración copiados."

# Eliminación de copias de seguridad antiguas (por ejemplo, más de 7 días)
echo "Eliminando copias de seguridad antiguas..."
find "$BACKUP_DIR" -type f -name "baserow_db_*.sql" -mtime +7 -delete
find "$BACKUP_DIR" -type f -name "baserow_media_*.tar.gz" -mtime +7 -delete
find "$BACKUP_DIR" -type f -name "docker-compose_*.yml" -mtime +7 -delete
find "$BACKUP_DIR" -type f -name ".env_*" -mtime +7 -delete
echo "Copias de seguridad antiguas eliminadas."

echo "Copia de seguridad de Baserow completada en $TIMESTAMP"

Haga que el script sea ejecutable:

chmod +x ~/baserow_backups/backup_baserow.sh # Hacemos el script ejecutable

3. Programación de copias de seguridad con Cron

Agregue el script a Cron para su ejecución diaria (por ejemplo, a las 3:00 de la madrugada):

crontab -e # Abrir crontab para editar

Agregue la siguiente línea al final del archivo (seleccione el editor nano si se le pregunta):

0 3 * * * /home/baserow_admin/baserow_backups/backup_baserow.sh >> /var/log/baserow_backup.log 2>&1

Esta línea significa: a las 3:00 de la madrugada, cada día, ejecutar el script y redirigir toda la salida al archivo de registro /var/log/baserow_backup.log.

4. Dónde almacenar las copias de seguridad

Almacenar las copias de seguridad en el mismo servidor que los datos de producción es extremadamente arriesgado. Si el servidor falla, perderá tanto los datos como las copias de seguridad. Se recomienda utilizar:

• Almacenamiento externo compatible con S3: Servicios como AWS S3, Backblaze B2, DigitalOcean Spaces. Se pueden usar utilidades como rclone o s3cmd para la sincronización automática de las copias de seguridad locales con S3.
• VPS separado: Un VPS económico en otra ubicación, donde se pueden copiar las copias de seguridad por SSH usando rsync.
• Almacenamiento en red (NAS): Si tiene su propia infraestructura.

Extienda el script de copia de seguridad añadiendo un paso para copiar los archivos a un almacenamiento remoto.

5. Actualizaciones: Rolling vs. Ventana de mantenimiento

Las actualizaciones regulares de Baserow y del software base son importantes para la seguridad y para obtener nuevas funciones.

• Actualización de Baserow:

  Para actualizar Baserow a una nueva versión (por ejemplo, de 1.24.x a 1.25.x), siga los siguientes pasos:

  1. ¡Realice una copia de seguridad completa! Este es el paso más importante antes de cualquier actualización.
  2. Detenga Baserow:

     
     cd ~/baserow
     docker compose down
                         

  3. Descargue las nuevas versiones de los archivos docker-compose.yml y .env (o compare y actualice los actuales):

     
     wget -O docker-compose.yml https://gitlab.com/baserow/baserow/-/raw/develop/deploy/docker-compose.yml
     # Verifique .env en busca de nuevas variables, si aparecieron en la nueva versión de Baserow
                         

  4. Inicie Baserow con las imágenes actualizadas:

     
     docker compose pull # Descarga de nuevas imágenes
     docker compose up -d # Inicio con nuevas imágenes y migración de la DB, si es necesario
                         

  5. Verifique los registros y la operatividad.

  Esto requerirá una breve ventana de mantenimiento (detención del servicio), ya que la base de datos podría requerir migración. Siempre lea la documentación oficial de actualización de Baserow para la versión específica.

• Actualización del SO y Docker:

  Actualice regularmente el sistema operativo y Docker Engine:

  
  sudo apt update && sudo apt upgrade -y
  sudo systemctl reboot # Reinicio para aplicar actualizaciones del kernel
              

  Las actualizaciones de Docker también pueden requerir el reinicio de los contenedores o incluso de todo el servidor. Planifique estas operaciones durante períodos de baja actividad.

Solución de problemas + Preguntas frecuentes

Incluso con el enfoque más cuidadoso, pueden surgir problemas. Aquí cubriremos escenarios y preguntas típicas.

El contenedor de Baserow no se inicia o se reinicia constantemente. ¿Qué hacer?

Qué verificar: En primer lugar, revise los registros del contenedor problemático. Por ejemplo, para el backend: docker compose logs baserow_backend. Preste atención a los mensajes de error. Las causas frecuentes son: falta de memoria, variables de entorno incorrectas en .env (especialmente DATABASE_URL, SECRET_KEY, BASEROW_PUBLIC_URL), conflictos de puertos, imágenes o volúmenes de Docker dañados.

Cómo solucionar: Asegúrese de que el VPS tenga suficiente RAM. Verifique la sintaxis y los valores en .env. Si sospecha que los volúmenes están dañados, intente detener Baserow (docker compose down) y, como medida extrema, elimine los volúmenes (docker volume rm baserow_data baserow_caddy_data baserow_caddy_config), y luego inicie de nuevo (¡perdiendo datos si no están respaldados!). A veces ayuda recrear completamente las imágenes: docker compose build --no-cache && docker compose up -d.

No puedo acceder a Baserow por el nombre de dominio, o HTTPS no funciona.

Qué verificar: Asegúrese de que el registro DNS de su dominio (por ejemplo, baserow.yourdomain.com) apunte a la dirección IP correcta de su VPS. Use ping su.dominio o dig su.dominio. Verifique que los puertos 80 y 443 estén abiertos en su VPS (sudo ufw status). Revise los registros de Caddy: docker compose logs caddy en busca de errores al obtener el certificado Let's Encrypt. Asegúrese de que BASEROW_PUBLIC_URL en .env y el dominio en caddy/Caddyfile coincidan.

Cómo solucionar: Corrija el registro DNS. Abra los puertos 80 y 443 en UFW. Si Caddy no puede obtener el certificado, es posible que haya un problema con la resolución DNS, o que el dominio no apunte a su servidor. Asegúrese de que el email en Caddyfile sea correcto.

Baserow funciona muy lento.

Qué verificar: Use htop o top en el VPS para verificar la carga de la CPU y el uso de RAM. La lentitud a menudo está relacionada con la falta de recursos. También revise los registros de Baserow en busca de errores repetitivos que puedan ralentizar el funcionamiento.

Cómo solucionar: Si falta RAM, considere aumentar la cantidad de memoria del VPS. Si la CPU está constantemente cargada, es posible que se necesiten más núcleos. Optimice las consultas en Baserow, evite tablas muy grandes con muchas relaciones y fórmulas complejas si el rendimiento es crítico. Asegúrese de que el subsistema de disco utilice SSD.

¿Qué configuración mínima de VPS es adecuada para Baserow?

Respuesta: Para pruebas o un equipo muy pequeño (1-2 usuarios), la configuración mínima es de 2 núcleos de CPU, 2 GB de RAM y 40 GB de SSD. Sin embargo, para un funcionamiento estable y cómodo con un equipo pequeño (hasta 10-15 personas), se recomienda al menos 2-4 núcleos de CPU, 4 GB de RAM y 80 GB de SSD. Un disco SSD es obligatorio para un buen rendimiento de la base de datos.

¿Qué elegir: VPS o dedicado para esta tarea?

Respuesta: Para la mayoría de los escenarios de uso de Baserow (proyectos personales, equipos pequeños y medianos), un VPS es la elección óptima. Ofrece suficiente rendimiento, flexibilidad y rentabilidad. Un servidor dedicado solo es necesario para cargas muy altas (cientos de usuarios activos, terabytes de datos), requisitos de hardware específicos o normas regulatorias estrictas que exigen un control total sobre el equipo físico. Comience con un VPS y escale a un dedicado si surge una necesidad real.

¿Cómo restablecer la contraseña de administrador de Baserow si la olvidé?

Qué verificar: Si ha configurado SMTP, puede usar la función "Olvidé mi contraseña" en la página de inicio de sesión. Si SMTP no está configurado, deberá restablecer la contraseña a través de la consola de Docker.

Cómo solucionar: Conéctese al servidor por SSH, vaya al directorio de Baserow (~/baserow). Luego, ejecute el comando para restablecer la contraseña del usuario con el correo electrónico especificado:

docker compose exec baserow_backend python3 manage.py reset_user_password --email [email protected]

Este comando generará una contraseña temporal que podrá usar para iniciar sesión y luego cambiarla en la interfaz de Baserow.

Se ha agotado el espacio en el disco del VPS.

Qué verificar: Use df -h para verificar el uso total del disco y du -sh /var/lib/docker/volumes/* para verificar los tamaños de los volúmenes de Docker. A menudo, el espacio es ocupado por imágenes de Docker antiguas, caché o registros.

Cómo solucionar: Limpie los objetos Docker antiguos: docker system prune -a (con precaución, elimina todos los contenedores detenidos, redes no utilizadas, imágenes y volúmenes). Elimine regularmente las copias de seguridad antiguas, especialmente las locales. Considere aumentar el espacio en disco del VPS o transferir las copias de seguridad a un almacenamiento externo.