Instalarlo en tus servidores

Orkan también se puede instalar en tus propios servidores. Es una opción B2B bajo contrato: los paquetes y la imagen se entregan al firmar, por lo que esta página no dice dónde descargarlos. Para pedirlo, escribe a contact@gnevoo.es. Si no necesitas controlar la infraestructura, la nube dedicada es más sencilla.

Qué se instala

orkan-server es un único programa que sirve la interfaz web y la API, recibe los datos de otras apps (los «enlaces para recibir datos») y ejecuta las automatizaciones.

Puerto	Para qué	Por defecto escucha en
`8787`	Interfaz web y API	`127.0.0.1`
`8788`	Enlaces para recibir datos	`127.0.0.1`
`9090`	Operación: `/health/live`, `/health/ready` y métricas. Sin autenticación: no lo expongas	`127.0.0.1`

Con paquetes `.deb` o `.rpm`

Hay paquetes para x86_64 y arm64.

sudo apt install ./orkan-server_<versión>_amd64.deb      # Debian y Ubuntu
sudo dnf install ./orkan-server-<versión>-1.x86_64.rpm   # Fedora, RHEL y derivados

La instalación crea el usuario de sistema orkan, deja la configuración en /etc/orkan/ y los datos en /var/lib/orkan/, e instala una unidad systemd endurecida que se habilita pero no se arranca.

Antes del primer arranque:

sudoedit /etc/orkan/orkan.toml    # revisa listen, public_url y data_dir
sudoedit /etc/orkan/orkan.env     # secretos y valores por entorno, si los necesitas
sudo -u orkan /usr/bin/orkan-server --config /etc/orkan/orkan.toml config check
sudo systemctl start orkan-server
sudo journalctl -u orkan-server -f

config check valida la configuración antes de arrancar nada.

Ponerlo en internet

El servicio escucha solo en 127.0.0.1. Para exponerlo, pon delante un proxy inverso con TLS y ajusta en orkan.toml:

public_url: la dirección pública, con https://.
trusted_proxies: las redes de tu proxy, para que Orkan lea bien la IP real de cada visita.

Si escucha fuera de loopback sin TLS, el servidor no arranca.

Con Docker

La imagen es linux/amd64 y linux/arm64, no lleva shell y se ejecuta con el usuario 65532.

Puertos: 8787 (web y API) y 9090 (operación); los enlaces para recibir datos en 8788.
Datos: monta un volumen en /var/lib/orkan.
Comprobaciones de salud (sin curl dentro): /health/live y /health/ready en el puerto 9090.
El sistema de ficheros puede ser de solo lectura: solo escribe el volumen.

Base de datos

Por defecto usa SQLite dentro de /var/lib/orkan. Para Postgres, configura ORKAN__DATABASE__KIND=postgres y ORKAN__DATABASE__URL (la URL lleva la contraseña: guárdala como secreto, nunca en la imagen).

Primer propietario

La primera vez que abres la dirección, Orkan te enseña «Prepara tu Orkan». Para crear la cuenta principal necesitas la clave de instalación:

Se imprime una sola vez en el registro del servidor al arrancar por primera vez (journalctl -u orkan-server).
Caduca a los 15 minutos. Para emitir otra: sudo -u orkan /usr/bin/orkan-server --config /etc/orkan/orkan.toml setup-token.
Escribe el nombre de tu Orkan, el de tu organización, tu nombre, tu correo, una contraseña de al menos 12 caracteres y la clave de instalación. Pulsa Crear cuenta.

Tu cuenta queda como propietaria. El resto lo explica personas y roles.

Copias de seguridad

Con SQLite, el propio programa crea y comprueba copias, incluso con el servidor en marcha:

sudo -u orkan /usr/bin/orkan-server --config /etc/orkan/orkan.toml backup create --out copia.tar.zst
sudo -u orkan /usr/bin/orkan-server --config /etc/orkan/orkan.toml backup verify copia.tar.zst

Con Postgres, la copia es un pg_dump tuyo; backup no funciona.

Restaurar (backup restore) exige parar antes el servidor. Mira también actualizaciones.

Licencia

Tu Orkan necesita una licencia que fija cuántas personas y ordenadores admite. Mira licencia.

Qué todavía no hay

Actualizador automático: las actualizaciones se instalan a mano. Mira actualizaciones.
Windows: existe un instalador MSI, pero no se ha probado instalado y no lo recomendamos todavía.
Cliente OAuth de Google, Microsoft y Salesforce: hay que configurarlo en el propio Orkan para poder conectar esas cuentas. Mira cuentas conectadas.