Instalación de ONLYOFFICE Docs Developer Edition para Debian, Ubuntu y derivados

Introducción

Developer Edition te permite instalar ONLYOFFICE Docs en tu servidor local e integrar los editores en línea con tu aplicación web (consulta la lista detallada de características). Esta guía te mostrará cómo instalar la versión Linux de ONLYOFFICE Docs Developer Edition en tu máquina.

Requisitos del sistema

• Procesador: doble núcleo de 2 GHz o superior
• RAM: al menos 2 GB, pero depende del sistema operativo host. Cuanto más, mejor
• HDD: al menos 40 GB de espacio libre
• SWAP: al menos 4 GB, pero depende del sistema operativo host. Cuanto más, mejor
• Sistema Operativo: Debian, Ubuntu de 64 bits u otra distribución compatible con la versión del kernel 3.13 o posterior
• Requisitos adicionales
  • PostgreSQL: versión 12.9 o posterior
  • NGINX: versión 1.3.13 o posterior
  • libstdc++6: versión 4.8.4 o posterior
  • Redis: versión 4 o posterior
  • RabbitMQ

Instalación de ONLYOFFICE Docs

La instalación con distribuciones basadas en Debian también requiere la presencia de libstdc++6, NGINX y PostgreSQL en el sistema.

Todas las instrucciones necesarias para estos componentes y la instalación de sus dependencias se pueden encontrar en sus sitios web oficiales.

Existen otras dependencias que se instalan junto con ONLYOFFICE Docs:

• libcurl3
• libxml2
• fonts-dejavu
• fonts-liberation
• ttf-mscorefonts-installer
• fonts-crosextra-carlito
• fonts-takao-gothic
• fonts-opensymbol

Estas dependencias se instalan automáticamente cuando usas Ubuntu 14.04 LTS o posterior. Las distribuciones anteriores podrían requerir su instalación manual.

Instalación de dependencias

ONLYOFFICE Docs utiliza NGINX y PostgreSQL como base de datos. Las dependencias encontradas en el repositorio del sistema se instalarán automáticamente durante la instalación de ONLYOFFICE Docs usando el comando apt-get install.

Instalación y configuración de PostgreSQL

Instala la versión de PostgreSQL incluida en tu versión de Ubuntu:

sudo apt-get install postgresql

nota

Si deseas instalar alguna otra versión de PostgreSQL desde el Repositorio de PostgreSQL, consulta la documentación oficial de PostgreSQL para más detalles.

Después de instalar PostgreSQL, crea la base de datos y el usuario de PostgreSQL:

nota

El usuario de la base de datos debe tener el nombre onlyoffice. Puedes especificar cualquier contraseña.

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

Instalación de Redis

sudo apt-get install redis-server

Instalación de RabbitMQ

sudo apt-get install rabbitmq-server

Instalación de NGINX

sudo apt-get install nginx

nota

En Ubuntu 18.04, instala el paquete nginx-extras en su lugar: sudo apt-get install nginx-extras

Importante

Si planeas ejecutar ONLYOFFICE Docs en el puerto 80, desactiva ahora el sitio web predeterminado de NGINX. De lo contrario, ONLYOFFICE Docs puede no funcionar correctamente. Para ello, ejecuta los siguientes comandos:

sudo mv -f /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.disabled
sudo mv -f /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo systemctl is-active --quiet nginx && sudo systemctl reload nginx || sudo systemctl start nginx

Según cómo se haya instalado NGINX, uno de los dos primeros comandos puede indicar que el archivo no existe. Puedes ignorar este mensaje sin problema.

nota

Las distribuciones de Ubuntu anteriores a 14.04 LTS podrían requerir la instalación de otras dependencias.

Cambiar el puerto predeterminado de ONLYOFFICE Docs

Por defecto, ONLYOFFICE Docs escucha las conexiones entrantes usando el puerto 8083. A partir de la versión 4.3 puedes cambiar el puerto para ONLYOFFICE Docs si planeas usar uno diferente al predeterminado.

nota

Si vas a cambiar el puerto predeterminado, asegúrate de que esté abierto para las conexiones entrantes/salientes. Consulta la lista completa de los puertos utilizados por ONLYOFFICE Docs.

Para hacerlo, necesitarás cambiar el puerto predeterminado para el sistema debconf, ejecutando el comando:

echo onlyoffice-documentserver-de onlyoffice/ds-port select <PORT_NUMBER> | sudo debconf-set-selections

Por favor, escribe el número de puerto en lugar de <PORT_NUMBER> en el comando anterior.

nota

Si estableces el puerto 80, asegúrate de haber desactivado el sitio web predeterminado de NGINX como se describe en la sección Instalación de NGINX.

Advertencia

Si deseas cambiar el protocolo de ONLYOFFICE Docs a HTTPS, no cambies el puerto a 443, sino utiliza esta instrucción en su lugar.

Existen opciones adicionales que se pueden utilizar para la instalación de ONLYOFFICE Docs. Por favor, lee esta sección para más información sobre ellas.

Después de eso, puedes continuar con la instalación de ONLYOFFICE Docs.

Instalación de ONLYOFFICE Docs

Agregar clave GPG:

mkdir -p -m 700 ~/.gnupg
curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | gpg --no-default-keyring --keyring gnupg-ring:/tmp/onlyoffice.gpg --import
chmod 644 /tmp/onlyoffice.gpg
sudo chown root:root /tmp/onlyoffice.gpg
sudo mv /tmp/onlyoffice.gpg /usr/share/keyrings/onlyoffice.gpg

Agregar repositorio de ONLYOFFICE Docs:

echo "deb [signed-by=/usr/share/keyrings/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list

nota

Aunque el paquete APT está construido contra Debian Squeeze, es compatible con varios derivados de Debian (incluyendo Ubuntu), lo que significa que puedes usar el mismo repositorio en todas estas distribuciones.

Al instalar ONLYOFFICE Docs en Debian, añade el componente contrib a /etc/apt/sources.list. Para obtener más información, puedes consultar la documentación de Debian.

Actualiza la caché del gestor de paquetes:

sudo apt-get update

Instala mscorefonts:

sudo apt-get install ttf-mscorefonts-installer

Instala ONLYOFFICE Docs:

sudo apt-get install onlyoffice-documentserver-de

nota

Durante el proceso de instalación, se te pedirá que proporciones una contraseña para el usuario de PostgreSQL onlyoffice. Por favor, introduce la contraseña de onlyoffice que especificaste al configurar PostgreSQL.

Después de eso, ONLYOFFICE Docs se ejecutará como un proceso. El paquete se actualizará como cualquier otro paquete deb.

Ahora puedes ingresar http://localhost:8083 en la barra de direcciones de tu navegador para abrir la página de bienvenida de ONLYOFFICE Docs, donde encontrarás más instrucciones sobre cómo habilitar ejemplos de documentos o integrar editores en línea en tu aplicación web utilizando la API proporcionada.

Ejecutar ONLYOFFICE Docs usando HTTPS

En la mayoría de los casos, acceder al portal a través del protocolo HTTPS es mucho más seguro que hacerlo a través de HTTP, que se utiliza por defecto. Puedes ejecutar fácilmente ONLYOFFICE Docs utilizando una conexión segura. Por favor, consulta los detalles aquí para obtener más información sobre cómo se puede hacer esto.

Registrar tu versión Developer Edition

Si compraste Developer Edition y recibiste el archivo license.lic, puedes colocarlo en tu instalación para obtener la versión completa del software.

Cuando eres usuario de una distribución basada en Debian, el archivo license.lic se coloca en la siguiente carpeta:

/var/www/onlyoffice/Data/license.lic

Después de eso, tu versión de Developer Edition estará registrada y con todas las funciones.

Información adicional: más opciones para la instalación de ONLYOFFICE Docs

La instalación de ONLYOFFICE Docs permite el uso de más opciones de debconf, que pueden ser muy útiles en caso de que planees instalarlo en más de un servidor o en otros casos.

Estas opciones incluyen:

• Opciones de la base de datos PostgreSQL

  • Establecer la dirección del host de la base de datos PostgreSQL (reemplazando <DB_HOST> con la dirección real del servidor PostgreSQL instalado):

    echo onlyoffice-documentserver-de onlyoffice/db-host string <DB_HOST> | sudo debconf-set-selections

  • Establecer el nombre de usuario de la base de datos PostgreSQL (reemplazando <DB_USER> con el nombre real del usuario con los derechos apropiados de la base de datos PostgreSQL):

    echo onlyoffice-documentserver-de onlyoffice/db-user string <DB_USER> | sudo debconf-set-selections

  • Establecer la contraseña del usuario de la base de datos PostgreSQL (reemplazando <DB_PASSWORD> con la contraseña real del usuario con los derechos apropiados de la base de datos PostgreSQL):

    echo onlyoffice-documentserver-de onlyoffice/db-pwd password <DB_PASSWORD> | debconf-set-selections

  • Establecer el nombre de la base de datos PostgreSQL (reemplazando <DB_NAME> con el nombre real de la base de datos PostgreSQL):

    echo onlyoffice-documentserver-de onlyoffice/db-name string <DB_NAME> | sudo debconf-set-selections

• Opciones de Redis

  • Establecer la dirección del host de Redis (reemplazando <REDIS_HOST> con la dirección real de Redis instalado):

    echo onlyoffice-documentserver-de onlyoffice/redis-host string <REDIS_HOST> | sudo debconf-set-selections

• Opciones de RabbitMQ

  • Establecer la dirección del host de RabbitMQ (reemplazando <RABBITMQ_HOST> con la dirección real de RabbitMQ instalado):

    echo onlyoffice-documentserver-de onlyoffice/rabbitmq-host string <RABBITMQ_HOST> | sudo debconf-set-selections

  • Establecer el nombre de usuario de RabbitMQ (reemplazando <RABBITMQ_USER> con el nombre real del usuario con los derechos apropiados de RabbitMQ):

    echo onlyoffice-documentserver-de onlyoffice/rabbitmq-user string <RABBITMQ_USER> | sudo debconf-set-selections

  • Establecer la contraseña del usuario de RabbitMQ (reemplazando <RABBITMQ_PWD> con la contraseña real del usuario con los derechos apropiados de RabbitMQ):

    echo onlyoffice-documentserver-de onlyoffice/rabbitmq-pwd password <RABBITMQ_PWD> | sudo debconf-set-selections

• Opciones JWT

  Puedes usar debconf-set-selections para desactivar la sobrescritura de los valores personalizados en el archivo local.json después de actualizar ONLYOFFICE Docs.

  • Habilitar JSON Web Tokens (JWT):

    echo onlyoffice-documentserver-de onlyoffice/jwt-enabled boolean true | sudo debconf-set-selections

  • Establecer una clave secreta JWT reemplazando <JWT_SECRET> con tu propio valor:

    echo onlyoffice-documentserver-de onlyoffice/jwt-secret password <JWT_SECRET> | sudo debconf-set-selections