# Actualizaciones

> Cómo se actualiza Orkan en la nube dedicada y en tus servidores, y cómo volver atrás si algo sale mal.

## En la nube dedicada

**Las aplica Gnevoo.** No tienes que hacer nada. Antes de actualizar tu espacio se hace una copia. Si tienes dudas sobre una versión concreta, mira las [novedades](https://wiki.itsorkan.com/novedades/).

## En tus servidores

Todavía **no hay actualizador automático**: instalas tú el paquete nuevo.

### Con paquetes `.deb` o `.rpm`

Instala el paquete nuevo **encima** del anterior:

```bash
sudo apt install ./orkan-server_<versión>_amd64.deb
sudo dnf upgrade ./orkan-server-<versión>-1.x86_64.rpm
```

-   Tu configuración (`/etc/orkan/`) se **conserva**. Si la has modificado, el gestor de paquetes te pregunta antes de sobrescribirla.
-   El servicio se **reinicia solo si estaba activo**.
-   Tus datos (`/var/lib/orkan`) no se tocan.

### Con Docker

Cambia la imagen por la nueva y reinicia, con el mismo volumen en `/var/lib/orkan`.

### Antes de actualizar

1.  **Haz una copia.** Con SQLite: `orkan-server --config <ruta> backup create --out <fichero>` y `backup verify <fichero>`. Con Postgres: `pg_dump`. Guarda aparte las claves de cifrado; mira [instalarlo en tus servidores](https://wiki.itsorkan.com/administrar/self-host/#copias-de-seguridad).
2.  Comprueba la configuración con el binario nuevo: `orkan-server --config <ruta> config check`.
3.  Instala la versión nueva (con paquetes, el servicio se reinicia solo si estaba activo). Comprueba que `/health/ready` (puerto `9090`) responde bien.

> **Recomendación, no un procedimiento oficial**
>
> Recomendación, no un procedimiento oficial
> 
> Estos pasos salen del comportamiento del programa y no están probados como procedimiento oficial. Si tu Orkan es crítico, pregúntanos antes: [contact@gnevoo.es](mailto:contact@gnevoo.es).

## Qué pasa con la base de datos

Las **migraciones** están dentro del programa y se aplican **solas al arrancar**. No hay un interruptor para desactivarlas.

No hay migraciones «hacia atrás». El esquema de cada versión está pensado para funcionar también con el programa de la versión anterior, para que volver atrás sea posible.

## Volver a la versión anterior

Vuelve a instalar el **programa anterior** sobre la misma base de datos; la base se queda como está. Excepción: si una versión ha cambiado la base de forma que exige una versión mínima, el programa antiguo **se niega a arrancar** y lo dice: «la base exige orkan-server >= …». En ese caso solo queda actualizar, o restaurar la copia de antes de actualizar.

Por eso la copia previa es importante: sirve para desastres, no para la vuelta atrás normal, pero hazla siempre.

## Qué todavía no hay

Un actualizador automático para Orkan instalado en tus servidores. Hasta entonces, la actualización es manual.