
Empieza
Instalar Agpiko
El cliente solo debe dar lo que no se puede inventar solo: dominio, un servidor con Node, y un admin.
Abrir el panelCLI
El camino fácil es un comando. Descarga el paquete firmado, comprueba el servidor y deja el sitio listo.
npx create-agpiko ./mi-sitio
Te pedirá dominio, email y contraseña (o usa --yes). Luego: admin en /admin/login. Actualizaciones: Buscar → Aplicar.
El paquete aún no está en el registro npm público. Mientras tanto, desde el árbol de origin: cd cli && npm run build && node dist/index.js create ./mi-sitio.
Camino fácil
Agpiko no se mete dentro de WordPress ni de un hosting solo PHP. Es una app Node con su panel.
1. Tienes un dominio (o uno que te den).
2. Tienes un VPS Linux con Node 22.13+ (o nos dejas instalarlo nosotros).
3. Corres la CLI (arriba). Entras a /admin/login.
4. Las versiones nuevas: panel → Actualizaciones → Buscar → Aplicar.
En tu PC
Para probar. Tres cosas no se pueden saltar: Node, un email/contraseña de admin, y arrancar.
1. Instala Node.js 22.13 o más nuevo.
2. Abre el paquete. En kernel/ copia .env.example a .env.local y pon solo email y contraseña de admin.
3. Ejecuta:
npm install
npm run db:seed
npm run dev
Entra en la URL que imprime Next, luego /admin/login.
En un servidor
Lo mínimo que el cliente (o su proveedor) tiene que tener listo antes:
• DNS apuntando al VPS.
• Sitio en el panel (CloudPanel u otro) con TLS.
• Usuario Linux del sitio y un puerto libre.
Después, un solo script (ops) hace el resto: descomprime, escribe .env.local, instala, compila, crea la base y arranca PM2. El proxy del panel debe apuntar a ese puerto.
Si lo haces a mano (sin script), desde kernel/:
npm install
npm run build
npm run db:seed
pm2 start ./node_modules/next/dist/bin/next --name agpiko -- start -p 3008
pm2 save
Usa el mismo puerto en PM2 y en el proxy. El canal y la clave pública ya van con valores por defecto del instalador; no los inventes.
Entra en https://tu-dominio/admin/login.
Después
No vuelvas a subir código a mano.
1. Panel → Actualizaciones.
2. Buscar.
3. Aplicar.
Eso reemplaza kernel/. Conserva site/, data/ y .env.local.
Qué pedimos y por qué
Dominio / DNS — Sí. Es suyo. Nosotros no podemos apuntarlo sin acceso.
TLS en el panel — Sí, o lo hace el proveedor. No vive dentro de Agpiko.
Servidor con Node — Sí, o hosting gestionado por Agpiko. No corre en PHP solo.
Email y contraseña admin — Sí (o se genera y se la enviamos).
Canal y clave pública — No. Van fijos en el instalador.
npm install / build / seed / PM2 — No. Los hace el script.
Editar nginx a mano — No. El panel apunta el proxy al puerto.
Elegir puerto — No, si el instalador elige uno libre.
Carpetas kernel/ site/ data/ — No. Salen del paquete. Solo debes saber que site/ es tu trabajo.
Actualizar por SFTP — Nunca. Usa Buscar → Aplicar.
Carpetas (referencia):
install/
kernel/ app (una actualización la reemplaza)
site/ tu proyecto (no se toca)
data/ SQLite y claves (no va en git)