# Instalar Devkron Edge `dkle` es un solo ejecutable, sin dependencias: no requiere .NET, ni OpenSSL, ni licencia. Se descomprime en una carpeta y se configura a mano; no instala servicios ni toca el sistema. ## Descargas Las versiones publicadas están en el repositorio público [Induxsoft/Devkron-2-Releases](https://github.com/Induxsoft/Devkron-2-Releases), en la carpeta `2.0-LTS/dkle/`, con una subcarpeta por versión que nunca se sobrescribe. La vigente es **2.0.1**: | Archivo | Plataforma | |---|---| | [dkle-2.0.1-Linux-x64.zip](https://github.com/Induxsoft/Devkron-2-Releases/raw/main/2.0-LTS/dkle/2.0.1/dkle-2.0.1-Linux-x64.zip) | Linux x64 (cualquier distribución: el ejecutable es estático) | | [dkle-2.0.1-Linux-arm64.zip](https://github.com/Induxsoft/Devkron-2-Releases/raw/main/2.0-LTS/dkle/2.0.1/dkle-2.0.1-Linux-arm64.zip) | Linux ARM64 (Raspberry Pi 4/5 con sistema de 64 bits, servidores ARM) | | [dkle-2.0.1-Windows-x64.zip](https://github.com/Induxsoft/Devkron-2-Releases/raw/main/2.0-LTS/dkle/2.0.1/dkle-2.0.1-Windows-x64.zip) | Windows 10, 11 y Windows Server 2016 o posterior, x64 | En la misma carpeta están `SHA256SUMS` (las sumas de los zips) y `manifest.json` (versión, commit y dependencias). Cada zip trae una carpeta `dkle--/` con: | Archivo | Qué es | |---|---| | `dkle` (`dkle.exe` en Windows) | El ejecutable: motor DKL, biblioteca Edge, servidor HTTP/HTTPS/FastCGI y las herramientas `run` y `check` | | `dkle.json.example` | Configuración del servidor, solo como ejemplo | | `ejemplo/` | Un sitio listo para probar (`hola.localhost`) con su `dkle.json` y su configuración | | `LEEME.md`, `NOTICE.txt`, `licencias/` | Instrucciones breves, avisos y licencias de los componentes de terceros | ## Verificar la descarga ``` sha256sum -c SHA256SUMS --ignore-missing ``` En Windows (PowerShell), compare el resultado con la línea del zip en `SHA256SUMS`: ```powershell Get-FileHash .\dkle-2.0.1-Windows-x64.zip -Algorithm SHA256 ``` ## Linux ``` unzip dkle-2.0.1-Linux-x64.zip sudo mkdir -p /opt/dkle sudo cp dkle-2.0.1-Linux-x64/dkle /opt/dkle/ sudo cp dkle-2.0.1-Linux-x64/dkle.json.example /opt/dkle/dkle.json sudo mkdir -p /opt/dkle/web /opt/dkle/_config /opt/dkle/dkle version ``` ## Windows Descomprima el zip y copie `dkle.exe` a `C:\dkle`, con las carpetas `web` y `_config`: ```powershell Expand-Archive .\dkle-2.0.1-Windows-x64.zip -DestinationPath . New-Item -ItemType Directory C:\dkle, C:\dkle\web, C:\dkle\_config | Out-Null Copy-Item .\dkle-2.0.1-Windows-x64\dkle.exe C:\dkle\ Copy-Item .\dkle-2.0.1-Windows-x64\dkle.json.example C:\dkle\dkle.json C:\dkle\dkle.exe version ``` ## Estructura de una instalación ``` /opt/dkle/ ├── dkle el ejecutable ├── dkle.json configuración del servidor ├── _config/ │ └── .dkle.json configuración de cada sitio (secretos, límites…) └── web/ └── / un sitio por host: los programas .dkl ├── _protected/routes.map rutas limpias (opcional) └── *.dkl ``` - Cada carpeta de `web/` es un sitio y su nombre es el host que atiende (`web/conectores.ejemplo.com/`). No hay una lista de sitios: basta con crear la carpeta. - `_config/` está fuera de `web/`, así que nunca se entrega por HTTP. Tampoco `_protected/`, y `dkle` no entrega archivos estáticos: solo ejecuta `.dkl`. - Las rutas relativas de `dkle.json` se resuelven contra la carpeta del propio `dkle.json`. Es la misma estructura de sitios de Devkron 2.0: la carpeta de un sitio se puede mover de un motor a otro (ver [Devkron Edge y Devkron 2.0](/es/devkron/2.0/dkle/devkron2.md)). ## Probar el ejemplo ``` cd dkle-2.0.1-Linux-x64/ejemplo ../dkle check --root . ../dkle run --root . GET /hola ../dkle serve -config dkle.json ``` `check` valida los programas, las rutas y la configuración; `run` lanza una petición simulada sin abrir puertos; `serve` atiende en `http://127.0.0.1:8080`. En otra terminal: ``` $ curl -H "Host: hola.localhost" http://127.0.0.1:8080/hola {"mensaje":"Hola desde Devkron Edge","fecha":"2026-11-01T15:56:08Z","ruta":"/hola"} $ curl http://127.0.0.1:8080/_health {"activo_s":1,"estado":"ok","sitios":1,"sitios_config_invalida":0,"version":"2.0.1"} ``` El servidor escribe su bitácora en la salida estándar, una línea JSON por evento. Se detiene con Ctrl+C (o `SIGTERM`): deja de aceptar conexiones y espera a que terminen las peticiones en curso. ## Dejarlo como servicio `dkle` no se registra solo como servicio: eso le toca al administrador del sistema. Estas son configuraciones de partida. ### Linux (systemd) Cree un usuario sin privilegios y la unidad `/etc/systemd/system/dkle.service`: ``` sudo useradd --system --home /opt/dkle --shell /usr/sbin/nologin dkle sudo chown -R dkle:dkle /opt/dkle ``` ```ini [Unit] Description=Devkron Edge (dkle) After=network-online.target Wants=network-online.target [Service] User=dkle Group=dkle ExecStart=/opt/dkle/dkle serve -config /opt/dkle/dkle.json # Secretos que los sitios pueden leer con env.get (lista "env" de cada _config/.dkle.json) EnvironmentFile=-/etc/dkle/entorno # Para escuchar en los puertos 80 y 443 sin ser root AmbientCapabilities=CAP_NET_BIND_SERVICE Restart=on-failure RestartSec=2 NoNewPrivileges=true [Install] WantedBy=multi-user.target ``` ``` sudo systemctl daemon-reload sudo systemctl enable --now dkle journalctl -u dkle -f # la bitácora JSON ``` `/etc/dkle/entorno` lleva una variable por línea (`PROVEEDOR_SECRETO=…`) y debe ser legible solo por root (`chmod 600`). ### Windows Como Devkron 2.0, con el Programador de tareas (detalle en [Servicio en Windows](/es/devkron/2.0/instalacion/servicio-windows.md)). Desde PowerShell como administrador: ```powershell $accion = New-ScheduledTaskAction -Execute "C:\dkle\dkle.exe" -Argument "serve -config C:\dkle\dkle.json" -WorkingDirectory "C:\dkle" $inicio = New-ScheduledTaskTrigger -AtStartup $config = New-ScheduledTaskSettingsSet -ExecutionTimeLimit ([TimeSpan]::Zero) -RestartCount 3 -RestartInterval (New-TimeSpan -Minutes 1) Register-ScheduledTask -TaskName "Devkron Edge" -Action $accion -Trigger $inicio -Settings $config -User "NT AUTHORITY\NETWORK SERVICE" ``` Las variables de entorno para `env.get` se definen como variables del sistema (Panel de control, Sistema, Variables de entorno) o en la cuenta con la que corre la tarea. ## Actualizar a otra versión 1. Descargue el zip de la versión nueva y verifique su suma. 2. Pruebe sus sitios con el ejecutable nuevo antes de reemplazar el anterior: `./dkle-nuevo check --root /opt/dkle`. 3. Reemplace el ejecutable y reinicie el servicio (`sudo systemctl restart dkle`). Las peticiones en curso terminan con el proceso anterior. `web/`, `_config/` y `dkle.json` no se tocan al actualizar.