Requisitos
Qué instalar antes de ejecutar tu paquete, con Docker o sin él.
Para el paquete Full Stack
Qué contiene cada paquete
| Paquete | Aplicaciones en la descarga | Funciona por sí solo |
|---|---|---|
| Full Stack | API, sitio web público, panel de espacios de trabajo | Sí, las tres juntas |
| SaaS Website | Sitio web público | Sí, con sus datos de ejemplo integrados; el formulario de contacto y el pago de licencias llegan a una API de Northstack cuando lo conectas a una |
| Workspace Dashboard | Panel de espacios de trabajo | Sí, con sus datos de ejemplo integrados en el navegador; las cuentas y los datos reales necesitan una API de Northstack |
| API Backend | API | Sí, solo sirve la API |
Un paquete de una sola aplicación no incluye las demás aplicaciones. El código de la API solo está en los paquetes Full Stack y Backend API.
Con Docker
- Docker Desktop en macOS o Windows, o Docker Engine con el plugin de Compose en Linux, con Docker Compose 2.24 o más reciente, que incluye todo Docker Desktop actual;
docker compose versionmuestra la tuya. La pila completa se inicia con un solo comandodocker compose, ydocker-compose.ymlleeback-end/.envsolo cuando existe, un ajuste que las versiones antiguas de Compose rechazan. - Una conexión a internet para la primera construcción, que descarga las imágenes base y las dependencias.
- Nada más: Docker incluye Node.js, y la base de datos es un archivo SQLite dentro de un volumen de Docker.
Con Docker
- Docker Desktop en macOS o Windows, o Docker Engine en Linux. Tu aplicación tiene su propio
Dockerfile; no necesitas Compose. - Una conexión a internet para la primera construcción, que descarga la imagen base y las dependencias.
Sin Docker
- Node.js 22.13 o una versión 22 posterior, o Node.js 24.11 o más reciente, para la API y el full stack (el
enginesde la API es^22.13.0 || >=24.11.0). El sitio web y el panel por sí solos funcionan con Node.js 22.9 o más reciente. Las imágenes de Docker usan Node.js 24. Comprueba el tuyo connode -v. - Yarn 4, mediante Corepack. Ejecuta
corepack enableuna vez; cada aplicación fija Yarn 4.8.1 enpackageManagere incluye suyarn.lock, así queyarn installinstala exactamente las versiones con las que se probó. Si tu Node.js no tiene Corepack (Node.js 25 y posteriores lo omiten), instálalo antes connpm install -g corepack. - Ningún paquete global.
Base de datos
Ningún servidor de base de datos. La API usa SQLite por defecto y yarn seed crea el archivo por ti; Docker también usa SQLite. MySQL se admite con un cambio de configuración, no de código.
Puertos
Cada aplicación escucha en un puerto local fijo. Asegúrate de que nada más los use o, con Docker, mueve uno con SITE_PORT, ADMIN_PORT o API_PORT en un .env junto a docker-compose.yml.
| Aplicación | Puerto |
|---|---|
| API | 8000 |
| Sitio web público | 3030 |
| Panel de espacios de trabajo | 3031 |
Puerto
El sitio web escucha en el puerto 3030. Conectado a una API, la espera en el 8000 salvo que le des otra dirección. Asegúrate de que nada más los use.
Puerto
El panel escucha en el puerto 3031. Conectado a una API, la espera en el 8000 salvo que le des otra dirección. Asegúrate de que nada más los use.
Puerto
La API escucha en el puerto 8000 y, por defecto, acepta el sitio web desde el 3030 y el panel desde el 3031. Asegúrate de que nada más use el puerto 8000.
Una API a la que conectarse
Tu aplicación no necesita nada más para iniciar: sin dirección de API funciona con sus datos de ejemplo integrados. Para trabajar con cuentas, pagos y correo reales necesita la API de Northstack, cuya dirección defines en su .env o pasas como argumento de construcción. La API se vende como su propio paquete, Backend API, y forma parte del Full Stack.
Servicios opcionales
Nada de esto hace falta para ejecutar Northstack en local. Cada servicio se activa con sus variables en el .env de la API; una variable que se deja vacía mantiene su función desactivada.
| Servicio | Sin él |
|---|---|
| Una cuenta de Stripe | Change plan, en la página de facturación del panel, abre el pago de prueba integrado, y el pago de licencias del sitio web abre su propio pago de prueba. Ninguno cobra a nadie, así que ambos flujos funcionan de principio a fin. |
| Una aplicación REST de PayPal | PayPal en el pago de licencias pasa por el mismo pago de prueba. |
| Un servidor SMTP para el correo | Las invitaciones, los restablecimientos de contraseña y los recibos de licencia se escriben en el registro de la API, con sus enlaces, en lugar de enviarse. |
| Un bucket de Cloudflare R2 | Los archivos y las imágenes de los proyectos se guardan en el propio disco de la API (con Docker, en el volumen de datos). |
| Una clave de IA de Google Gemini, OpenAI o DeepSeek, cualquiera de las tres | Cada persona puede añadir su propia clave de un proveedor en el asistente, guardada en su navegador; sin ella el asistente no puede responder. Todo lo demás funciona. |
| Una clave para el servidor MCP | POST /api/mcp rechaza todas las peticiones. |
Cada servicio de pago te factura en tu propia cuenta con ese proveedor. Northstack no cobra impuestos por sí mismo: configura los impuestos de tu país antes de aceptar pagos reales.