Instalación en RedHat y CentOS

Preliminares

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

$ df -h

Una vez verificado, cree el usuario “openkm”:

$ adduser openkm

Si Java 17 aún no está instalado, instale lo siguiente:

$ yum install java-1.17.0-openjdk

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

# java -version
openjdk version "17.0.18" 2026-01-20
OpenJDK Runtime Environment (build 17.0.18.1+1)
OpenJDK 64-Bit Server VM (build 17.0.18.1+1, mixed mode, sharing)

De lo contrario, establezca Java 17 como el predeterminado:

$ update-alternatives --config java

Si no tiene ninguna otra preferencia de base de datos, le sugerimos instalar MariaDB:

$ yum install mariadb-server

Después, active e inicie el servicio de MariaDB:

$ systemctl enable mariadb
$ systemctl start 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, así 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 finalizado, asegúrese de que Java 17 sea el predeterminado:

$ java -version

De lo contrario, establézcalo como predeterminado:

$ update-alternatives --config java

Una vez verificado, inicie los servicios necesarios:

$ systemctl start xvfb openkm

Puede verificar el estado de estos servicios de la siguiente manera:

$ systemctl status xvfb openkm

Más información en:

Habilitar el acceso remoto

Red Hat no permite conexiones al puerto 8080 por defecto, así que necesita abrir este puerto en el cortafuegos:

$ firewall-cmd --zone=public --permanent --add-port=8080/tcp
$ firewall-cmd --reload

Lista de comprobación posterior a la instalación

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

Verifique que el Java por defecto es Java 17.
Verifique que puede acceder a OpenKM desde otro equipo.
Intente iniciar sesión con el usuario y contraseña por defecto okmAdmin / admin.
Suba un documento de 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