Instalación en Ubuntu y Debian

Preliminares

Asegúrese de tener suficiente espacio en disco para instalar OpenKM y almacenar el repositorio de documentos:

$ df -h

Una vez comprobado, cree el usuario “openkm”:

$ adduser openkm

Si Java 17 todavía no está instalado, instale lo siguiente:

$ apt install openjdk-17-jre

OpenKM actualmente solo funciona con Java 17, así que, una vez completado el proceso de instalación, verifique que la versión por defecto es Java 17:

$ java -version
openjdk version "17.0.18" 2026-01-20
OpenJDK Runtime Environment (build 17.0.18+8-Ubuntu-124.04.1)
OpenJDK 64-Bit Server VM (build 17.0.18+8-Ubuntu-124.04.1, mixed mode, sharing)

En caso contrario, establezca Java 8 como el predeterminado:

$ update-alternatives --config java

Si prefiere una base de datos distinta, le sugerimos instalar MariaDB:

$ apt install mariadb-server

Después, compruebe si el servicio de MariaDB ya se ha iniciado:

$ systemctl status mariadb

Instalar OpenKM

Puede elegir entre instalar OpenKM en “/home/openkm” o en “/opt”. En cualquier caso, vaya a la ruta elegida y descargue el instalador.

Es un instalador basado en texto, por lo que debe ejecutarlo desde la consola como root. Esto se debe a que necesita instalar dependencias de paquetes y configurar OpenKM como un servicio:

$ java -jar OKMInstaller.jar

Recuerde consultar Using the installer si está usando un proxy para acceder a Internet.

Cuando el proceso de instalación haya terminado, asegúrese de que Java 17 es el predeterminado:

$ java -version

En caso contrario, establézcalo como predeterminado:

$ update-alternatives --config java

Una vez comprobado, inicie los servicios necesarios:

$ systemctl start xvfb openkm

Puede verificar el estado de estos servicios de esta forma:

$ systemctl status xvfb openkm

Lista de comprobación posterior a la instalación

Para verificar que la instalación se ha realizado correctamente, use esta lista de comprobación:

Verifique que el Java predeterminado es Java 17.
Verifique que puede acceder a OpenKM desde otro ordenador.
Intente iniciar sesión con el usuario y contraseña por defecto okmAdmin / admin.
Suba un documento Word y compruebe si se genera la miniatura y se muestra la vista previa.

Solución de problemas

Si tiene un problema con la generación de miniaturas, verifique que tiene instalado el paquete ImageMagick y que la aplicación “convert” funciona.

Descargue una imagen de ejemplo desde Sample PNG Image e intente generar una miniatura:

$ wget https://www.sample-videos.com/img/Sample-png-image-1mb.png
$ convert -thumbnail '80x80>' -background 'white' -flatten Sample-png-image-1mb.png sample-output.png