Saltar al contenido principal

Inicio rápido con Docker Compose

Esta página arranca un sol2flow autoalojado con Docker Compose: la app y una base de datos PostgreSQL. Úsala para probar sol2flow en tu propio hardware. Para un servidor de producción, sigue después la Instalación, que añade HTTPS, correo y copias de seguridad.

Sin servidor

Para usar sol2flow sin gestionar un servidor, crea una cuenta en la nube.

Qué necesitas​

  • Un equipo con Docker y el plugin Docker Compose (Linux, macOS o Windows con WSL 2).
  • Alrededor de 1 GB de memoria libre y unos cuantos GB de disco para la base de datos y los archivos subidos.
  • openssl (o cualquier otra forma de generar secretos aleatorios).

1. Crea una carpeta con dos archivos​

mkdir sol2flow && cd sol2flow

Crea compose.yml:

name: sol2flow
services:
  app:
    image: ghcr.io/sol2flow/sol2flow:${SOL2FLOW_VERSION:-latest}
    restart: unless-stopped
    env_file: .env
    environment:
      DATABASE_URL: postgresql://sol2flow:${POSTGRES_PASSWORD:-sol2flow}@db:5432/sol2flow?schema=public
    ports: ["3000:3000"]
    volumes: [uploads:/data/uploads]
    depends_on: { db: { condition: service_healthy } }
  db:
    image: postgres:18-alpine
    restart: unless-stopped
    environment: { POSTGRES_USER: sol2flow, POSTGRES_PASSWORD: "${POSTGRES_PASSWORD:-sol2flow}", POSTGRES_DB: sol2flow }
    volumes: [pgdata:/var/lib/postgresql] # from PostgreSQL 18 not …/data (data: …/18/docker)
    healthcheck: { test: ["CMD-SHELL", "pg_isready -U sol2flow"], interval: 5s, retries: 20 }
volumes: { pgdata: {}, uploads: {} }

Crea .env con tus propios secretos y el primer administrador:

cat > .env <<ENV
APP_URL=http://localhost:3000
AUTH_SECRET=$(openssl rand -base64 32)
APP_ENCRYPTION_KEY=$(openssl rand -base64 32)
POSTGRES_PASSWORD=$(openssl rand -hex 16)
[email protected]
BOOTSTRAP_ADMIN_USERNAME=admin
BOOTSTRAP_ADMIN_PASSWORD=choose-a-long-password
ENV

2. Arráncalo​

docker compose up -d
docker compose logs -f app     # wait for "applying migrations", then the server start; Ctrl+C stops following

El esquema de la base de datos se crea automáticamente en el primer arranque.

3. Inicia sesión​

Abre http://localhost:3000 e inicia sesión con el BOOTSTRAP_ADMIN_USERNAME y la BOOTSTRAP_ADMIN_PASSWORD de tu .env. Esa cuenta tiene el rol Propietario de la instancia. La instancia empieza vacía: no hay otras cuentas ni datos de demostración. Después:

  1. Crea tu primer espacio de trabajo y tu primer tablero.
  2. Abre Administración para revisar los ajustes de la instancia (Administración).
  3. Quita BOOTSTRAP_ADMIN_PASSWORD de .env. Solo se lee mientras la instancia no tiene usuarios.
Correos

De serie, los correos (invitaciones, restablecimientos de contraseña) se escriben en el log de la app en lugar de enviarse. Configura SMTP antes de invitar a nadie.

Próximos pasos​