Saltar al contenido principal

Primeros pasos

QA Hub está disponible como servicio en la nube o como despliegue autoalojado con Docker.

Nube (recomendado)​

Regístrate en qahub.cloud → Create an account. Tu espacio de trabajo se crea de inmediato; un administrador de QA Hub lo aprueba antes de que tengas acceso completo (normalmente en minutos con el plan cloud).

Autoalojado con Docker Compose​

Requisitos previos​

  • Docker Engine 24+ y Docker Compose v2+
  • 1 GB de RAM como mínimo (se recomiendan 2 GB)
  • Un nombre de dominio si planeas exponerlo públicamente

1. Clonar el repositorio​

git clone https://github.com/your-org/qa-hub.git
cd qa-hub

2. Configurar las variables de entorno​

cp .env.example .env

Abre .env y configura las dos variables obligatorias:

# Conexión a PostgreSQL — el valor por defecto de Docker Compose funciona sin cambios
DATABASE_URL=postgresql://qahub_user:qahub_password@localhost:5432/qa_hub?schema=public

# Clave de cifrado para las API keys de IA almacenadas en la base de datos — mínimo 32 caracteres
APP_SECRET=replace-this-with-a-long-random-string-at-least-32-chars

Variables opcionales:

# URL pública — usada en emails de restablecimiento de contraseña y callbacks OAuth
NEXT_PUBLIC_APP_URL=https://qa.tu-empresa.com

# SMTP — si no se configura, los flujos de email se degradan sin errores (no se envía nada)
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=no-reply@example.com
SMTP_PASS=your-smtp-password
SMTP_FROM="QA Hub <no-reply@example.com>"

3. Iniciar el stack​

docker-compose up -d

Esto inicia PostgreSQL y la aplicación QA Hub. El esquema de la base de datos se aplica automáticamente en el primer arranque — no necesitas ningún paso de migración manual.

4. Abrir la aplicación​

Navega a http://localhost:3000. En el primer arranque aparece la página de registro.

Primer inicio de sesión​

  1. Ve a Register y crea tu cuenta con nombre, email y contraseña.
  2. Tu cuenta empieza como Pending. Un SUPER_ADMIN debe aprobarla antes de que puedas iniciar sesión.
  3. Una vez aprobada, inicia sesión — llegarás al panel principal.
Aprobar tu propia cuenta en una instalación nueva

En una instalación autoalojada completamente nueva aún no hay SUPER_ADMINs. Conéctate directamente a la base de datos y actualiza el estado del tenant de tu usuario:

UPDATE "Tenant" SET status = 'ACTIVE' WHERE id = '<your-tenant-id>';

Después, inicia sesión con normalidad. Tu cuenta tendrá el rol QA_MANAGER y podrás invitar a miembros del equipo.

Qué viene después​