# Crear un sitio con createsite
`createsite.dkl` es una herramienta de consola de dkl-web que crea la carpeta de un sitio nuevo copiando una plantilla de `_templates/sites/`. La distribución trae la plantilla **`blank`**: un sitio vacío, con la carpeta protegida, la regla de la API FSO y un `auth.dk` que identifica al usuario.
## Uso
Desde la carpeta de la instalación (las rutas son relativas a ella):
```bash
cd /opt/devkron
./dkl createsite blank tienda.localhost
```
Salida real (con 2.0):
```text
Iniciado 10/27/2026 17:21:20
ID de ejecución: 8add6c89e55c4501bb4bbdc7911a8d92
web/tienda.localhost/index.dkl
web/tienda.localhost/_protected/auth.dk
web/tienda.localhost/_protected/ext.map
web/tienda.localhost/_protected/idp/dbidp.dk
web/tienda.localhost/_protected/idp/default.dk
Terminado 10/27/2026 17:21:20
00:00:00.1285554
```
| Argumento | Significado |
|---|---|
| primero | Nombre de la plantilla: una carpeta de `_templates/sites/` |
| segundo | Nombre del host del sitio nuevo: se crea `web/
Sitio Web vacío
``` ### Ajuste necesario en ext.map La regla que trae la plantilla es `.fso > $/fso/fso.*.dkl`, una ruta **absoluta** (`/fso/...` en la raíz del disco). En una instalación normal los servicios FSO están en la carpeta `fso/` de Devkron, así que cámbiela a la forma relativa a la instalación (`$` sin barra): ```text # Este es un mapa de rutas por extensión .fso > $fso/fso.*.dkl ``` Comprobado con 2.0: con la regla original, `GET /documentos/lst.fso` responde 404; con `$fso/fso.*.dkl`, responde la lista. ### auth.dk e idp/ El `auth.dk` de la plantilla se ejecuta en cada petición: carga el proveedor de identidad `_protected/idp/default.dk`, arma `@http_context/session` y, si el recurso pedido tiene un manifiesto de privilegios con `read`, exige sesión y privilegio. Mientras el sitio no tenga manifiestos (`._p_`), deja pasar todo. `default.dk` valida el token contra la API de Induxsoft (`https://api.induxsoft.net/auth/login/`), de modo que **cada petición con token hace una llamada HTTP** a esa API. Si su sitio autentica contra su propia base de datos, sustitúyalo por el ejemplo `dbidp.dk`. Todo esto se explica en [Autenticación y autorización](/es/devkron/2.0/marcos/autenticacion/). ## Publicar el sitio en nginx Agregue un `server` con el nombre del host y pase todo al servidor FastCGI: ```nginx server { listen 80; server_name tienda.localhost; client_max_body_size 50m; location / { include fastcgi_params; fastcgi_pass devkron; # el upstream del servidor FastCGI } } ``` La configuración completa de nginx (upstream, socket Unix, keepalive) está en [Instalación y configuración](/es/devkron/2.0/instalacion/). La guía [Crear un sitio nuevo con nginx](/es/devkron/2.0/guias/sitio-nuevo-nginx.md) lo recorre de principio a fin. ## Errores típicos | Síntoma | Causa y solución | |---|---| | `No existe la plantilla indicada 'x'` | No hay carpeta `_templates/sites/x/`; ejecute desde la carpeta de la instalación | | `{0} Faltan parámetros.` | Faltan el nombre de la plantilla o el host | | Los servicios `.fso` responden 404 | Cambie la regla de `ext.map` a `.fso > $fso/fso.*.dkl` | | Todas las páginas tardan cuando llevan token | `idp/default.dk` llama a la API de Induxsoft en cada petición; use un proveedor propio si no necesita esa API |