---
author: Daniel A. Rodriguez
date: 2021-03-26
---

# OxOOL (OxOffice Online) Community Edition

OxOffice Online es una suite ofimática en línea de código abierto, autoalojable y basada en LibreOffice Online.

Sus características incluyen:

*   Edición básica y compartida
*   Alta fidelidad, representación WYSIWYG
*   Soporta el estándar mundial Open Document Format e incluso formatos privativos como DOC/DOCX, PPT/PPTX, XLS/XLSX

_Está disponible para RockyLinux 8 y Ubuntu 24.04. Si estás interesado en probarlo en otra plataforma puedes [descargar el último código fuente de GitHub](https://github.com/OSSII/oxool-community) e intentar compilarlo._

OxOffice Online y Nextcloud pueden estar en el mismo servidor o en dos diferentes.

### Instalación

Como primer paso es necesario descargar imágenes del sistema base de entre las disponibles. Para crear contenedores las imágenes deben haber sido descargadas previamente.

Actualizamos el catálogo de plantillas disponibles:

```bash
# pveam update
```

Listamos las plantillas disponibles:

```bash
# pveam available --section system
...
system ubuntu-20.04-standard_20.04-1_amd64.tar.gz
system ubuntu-22.04-standard_22.04-1_amd64.tar.zst
system ubuntu-24.04-standard_24.04-2_amd64.tar.zst
system ubuntu-24.10-standard_24.10-1_amd64.tar.zst
system ubuntu-25.04-standard_25.04-1.1_amd64.tar.zst
...
```

Para cada plantilla que querramos utilizar, la descargamos usando:

```bash
# pveam download local ubuntu-24.10-standard_20.10-1_amd64.tar.zst
```

Estamos listos para crear contenedores usando esa imagen. Se puede listar todas las imágenes locales con:

```bash
# pveam list local
NAME                                                    SIZE 
local:vztmpl/debian-12-standard\_12.7-0\_amd64.tar.zst     120.65MB
local:vztmpl/ubuntu-20.10-standard\_20.10-1\_amd64.tar.zst 136.83MB
```

En este punto, desde la interfaz web, deberías poder hacer clic en el botón ‘Create CT’ y elegir entre las plantillas disponibles.

Ahora bien, si preferís la linea de comandos, para crear un nuevo contenedor usamos

```bash
pct create 10 local:vztmpl/ubuntu-20.10-standard\_20.10-1\_amd64.tar.zst --rootfs local-lvm:24 --cores 2 --net0 name=ens18,bridge=vmbr0,ip=10.11.1.10/24,gw=10.11.1.1 --nameserver 10.11.1.1 --password 123456789 --timezone host
```

La clave definida en el comando anterior es para el usuario root. Dado que no podremos conectarnos por SSH utilizando ese usuario, iniciamos una terminal en el contenedor
```bash
pct enter 10
```
A partir de este punto podremos, por ejemplo, agregar usuarios y habilitar el acceso SSH

Reiniciamos el equipo y luego ejecutamos estos comandos para instalar los programas necesarios junto con OxOOL Community Edition
```bash
apt update
apt upgrade -y
apt install nano openssh-server net-tools curl -y
# Chooese yes if you get any service restarting prompts
curl -o /etc/apt/keyrings/OSSII.asc http://www.oxoffice.com.tw/deb/OSSII.key
curl -o /etc/apt/sources.list.d/oxool-community-v5-noble.list http://www.oxoffice.com.tw/deb/oxool-community-v5-noble.list
apt update
apt install oxool -y
```
Definimos que el servicio OxOOL Community Edition se inicie al arrancar y luego reiniciamos
```bash
systemctl enable oxool
reboot
```
Comprobamos si OxOOL Community Edition inicia normalmente
```bash
netstat -tlnp
```
Deberías obtener un resultado similar a este:
```bash
tcp6 0 0 :::9980 :::\* LISTEN 644/oxool
```
### Configurar un proxy reverso

Dependiendo de la infraestructura disponible puede ser necesario configurar un proxy reverso. Para ello se puede utilizar Apache o Nginx.

#### Con SSL o sin SSL

La regla del punto de conexión se puede resumir como

*   wss se conecta sólo en https
*   ws se conecta en http

y viceversa:

*   https sólo acepta wss
*   http sólo acepta ws

#### Apache

Para poder procesar el tráfico, es necesario habilitar los siguientes módulos: proxy, proxy\_connect, proxy\_http, proxy\_wstunnel. Para ello
```bash
a2enmod proxy proxy_connect proxy_http proxy_wstunnel
```
Crearemos un host virtual y, dependiendo de la necesidad, utilizaremos una de las siguientes configuraciones de ejemplo:
```bash
nano /etc/apache2/sites-available/oxool.conf
```
Sustituiremos el nombre de dominio que utilizamos para OxOffice Online. No debes olvidar crear un registro A para este subdominio en el DNS.

#### 1. SSL en ambos extremos:

La config correspondiente en /etc/oxool/oxoolwsd.xml es:
```bash
<ssl desc="**SSL settings**">
        <enable type="bool">true</enable>
</ssl>
```
Host virtual Apache

```bash
<VirtualHost *:443>
  ServerName odfweb.dominio.edu.ar:443
  Options -Indexes
  # Encoded slashes need to be allowed
  AllowEncodedSlashes NoDecode
  SSLProxyEngine On
  ProxyPreserveHost On

 # cert is issued for collaboraonline.example.com and we proxy to localhost
 SSLProxyVerify None
 SSLProxyCheckPeerCN Off
 SSLProxyCheckPeerName Off

 oxool_communitty = «oxoolhost»:9980

 # static html, js, images, etc. served from oxoolwsd
 # browser is the client part of Collabora Online
 ProxyPass           /browser https://${oxool\_communitty}/browser retry=0
 ProxyPassReverse    /browser https://${oxool\_communitty}/browser

 # WOPI discovery URL
 ProxyPass           /hosting/discovery https://${oxool\_communitty}/hosting/discovery retry=0
 ProxyPassReverse    /hosting/discovery https://${oxool\_communitty}/hosting/discovery

 # Capabilities
 ProxyPass           /hosting/capabilities https://${oxool\_communitty}/hosting/capabilities retry=0
 ProxyPassReverse    /hosting/capabilities https://${oxool\_communitty}/hosting/capabilities

 # Main websocket
 ProxyPassMatch      "/(c|ox)ool/(.\*)/ws$"      wss://${oxool\_communitty}/oxool/$1/ws nocanon

 # Admin Console websocket
 ProxyPass           /(c|l)ool/adminws wss://${oxool\_communitty}/oxool/adminws

 # Download as, Fullscreen presentation and Image upload operations
 ProxyPass           /(c|ox)ool https://${oxool\_communitty}/oxool
 ProxyPassReverse    /(c|ox)ool https://${oxool\_communitty}/oxool
 # Compatibility with integrations that use the /lool/convert-to endpoint
 ProxyPass           /lool https://${oxool\_communitty}/oxool
 ProxyPassReverse    /lool https://${oxool\_communitty}/oxool
</VirtualHost>
```
#### 2. SSL termina en el proxy:

La config correspondiente en /etc/oxool/oxoolwsd.xml es:
```bash
<ssl desc="**SSL settings**">
        <enable type="bool">false</enable>
        <termination>true</termination>
</ssl>
```
Host virtual Apache

```bash
<VirtualHost *:443>
  ServerName odfweb.dominio.edu.ar:443
  Options -Indexes
  # Encoded slashes need to be allowed
  AllowEncodedSlashes NoDecode
  ProxyPreserveHost On

 # static html, js, images, etc. served from oxoolwsd
 # browser is the client part of Collabora Online
 ProxyPass           /browser http://${oxool\_communitty}/browser retry=0
 ProxyPassReverse    /browser http://${oxool\_communitty}/browser

 # WOPI discovery URL
 ProxyPass           /hosting/discovery http://${oxool\_communitty}/hosting/discovery retry=0
 ProxyPassReverse    /hosting/discovery http://${oxool\_communitty}/hosting/discovery

 # Capabilities
 ProxyPass           /hosting/capabilities http://${oxool\_communitty}/hosting/capabilities retry=0
 ProxyPassReverse    /hosting/capabilities http://${oxool\_communitty}/hosting/capabilities

 # Main websocket
 ProxyPassMatch      "/(c|ox)ool/(.\*)/ws$"      ws://${oxool\_communitty}/oxool/$1/ws nocanon

 # Admin Console websocket
 ProxyPass           /(c|l)ool/adminws ws://${oxool\_communitty}/oxool/adminws

 # Download as, Fullscreen presentation and Image upload operations
 ProxyPass           /(c|ox)ool http://${oxool\_communitty}/oxool
 ProxyPassReverse    /(c|ox)ool http://${oxool\_communitty}/oxool

 # Compatibility with integrations that use the /lool/convert-to endpoint
 ProxyPass           /lool http://${oxool\_communitty}/oxool
 ProxyPassReverse    /lool http://${oxool\_communitty}/oxool
</VirtualHost>
```
Guardamos el archivo y habilitamos este host virtual:
```bash
sudo a2ensite oxool.conf
```
Luego recargamos la configuración de Apache.
```bash
systemctl restart apache2
```
#### Obtener e instalar certificados TLS

Dado que en otro artículo se explica cómo [instalar, configurar y poner en marcha Apache con el módulo mod\_md](https://informatica.unau.edu.ar/securizar-apache-con-mod_md-y-lets-encrypt/) no vamos a ahondar sobre el tema en esta oportunidad.

#### Nginx

Crearemos un host virtual y, dependiendo de la necesidad, utilizaremos una de las siguientes configuraciones de ejemplo:
```bash
nano /etc/nginx/sites-available/oxool.conf
```
Sustituiremos el nombre de dominio que utilizamos para OxOffice Online. No debes olvidar crear un registro A para este subdominio en el DNS.

#### 1. SSL en ambos extremos:

La config correspondiente en /etc/oxool/oxoolwsd.xml es:
```bash
<ssl desc="**SSL settings**">
        <enable type="bool">true</enable>
</ssl>
```
Bloque server Nginx
```bash
upstream oxool-community {
    server «oxoolhost»:9980;
    keepalive 32;
    }

 # static files
   location ^~ /browser {
   proxy\_pass https://oxool-community;
   proxy\_set\_header Host $host;
 }

 # WOPI discovery URL
   location ^~ /hosting/discovery {
   proxy\_pass https://oxool-community;
   proxy\_set\_header Host $host;
 }

 # Capabilities
   location ^~ /hosting/capabilities {
   proxy\_pass https://oxool-community;
   proxy\_set\_header Host $host;
 }

 # main websocket
   location ~ ^/(c|ox)ool/(.\*)/ws$ {
   proxy\_pass https://oxool-community;
   proxy\_set\_header Upgrade $http\_upgrade;
   proxy\_set\_header Connection "Upgrade";
   proxy\_set\_header Host $host;
   proxy\_read\_timeout 36000s;
 }

 # download, presentation and image upload
 location ~ ^/(c|l)ool {
   proxy\_pass https://oxool-community;
   proxy\_set\_header Host $host;
 }

 # Admin Console websocket
 location ^~ /(c|ox)ool/adminws {
   proxy\_pass https://oxool-community;
   proxy\_set\_header Upgrade $http\_upgrade;
   proxy\_set\_header Connection "Upgrade";
   proxy\_set\_header Host $host;
   proxy\_read\_timeout 36000s;

 }

}
```
#### 2. SSL termina en el proxy:

La config correspondiente en /etc/oxool/oxool.xml es:
```bash
<ssl desc="**SSL settings**">
        <enable type="bool">false</enable>
        <termination>true</termination>
</ssl>
```
Bloque server Nginx
```bash
upstream oxool-community {
    server «oxoolhost»:9980;
    keepalive 32;
    }

    server {
    listen       443 ssl;
    server\_name  odfweb.dominio.edu.ar;
    ssl\_certificate /ruta/a/certificado\_ssl;
    ssl\_certificate\_key /ruta/a/llave\_certificado\_ssl;
	
    proxy\_set\_header Host $host;
    proxy\_set\_header X-Forwarded-For $remote\_addr;
    proxy\_set\_header X-Forwarded-Proto $scheme;

    proxy\_read\_timeout 36000s;

 # Archivos estáticos
 location ^~ /browser {
   proxy\_pass http://oxool-community;
   proxy\_set\_header Host $host;
 }

 # Capacidades y descubrimiento WOPI
 location ~ ^/hosting/(discovery|capabilities) {
   proxy\_pass http://oxool-community;
   proxy\_set\_header Host $host;
 }

 # main websocket
 location ~ ^/(oxool|cool)/(.\*)/?$ {
   proxy\_pass http://oxool-community;
   proxy\_set\_header Host $host;
   proxy\_set\_header X-Forwarded-For $remote\_addr;
   proxy\_set\_header X-Forwarded-Proto $scheme;

   proxy\_http\_version 1.1;
   proxy\_set\_header Upgrade $http\_upgrade;
   proxy\_set\_header Connection "upgrade";

   proxy\_read\_timeout 36000s;
   proxy\_redirect off;
 }

 # Mejora desempeño de recursos estáticos
 location ~\* \\.(js|css|png|jpg|jpeg|gif|ico|svg|woff2)$ {
   proxy\_pass http://oxool-community;
   proxy\_set\_header Host $host;
   expires 30d;
   add\_header Cache-Control "public, immutable";
   access\_log off;
 }
```
Guardamos el archivo y verificamos la configuración de Nginx.
```bash
nginx -t
```
Si no hay errores, recargamos Nginx.
```bash
systemctl reload nginx
```
## Conexión a Nextcloud

![NextcloudOffice](img/NextcloudOfficeSettings.png)

Inicia sesión en Nextcloud como administrador:
Hacemos clic en *Nombre de usuario* en la esquina superior derecha de la pantalla → *+ Aplicaciones*
Buscamos Nextcloud Office en el lado izquierdo de la pantalla, seleccionamos *Activar* → ingrese la contraseña del administrador del sistema.
Una vez activada esta aplicación, vamos a la configuración de Nextcloud. Hacemos clic en la pestaña Nextcloud Office de la izquierda. Tenemos que seleccionar «Use su propio servidor» e introducir el nombre de dominio de nuestro OxOffice Online incluyendo el prefijo https://, luego hacemos clic en el botón *Save*.

Tras completar la configuración, cuando hagas clic en el botón de añadir (+) en Nextcloud, podrás crear documentos de texto, hojas de cálculo y presentaciones directamente desde tu navegador web.

![NextcloudOffice File options](img/NextcloudOfficeFileOptions.png)

La consola de administración de OxOOL está disponible en `https://odfweb.dominio.edu.ar/browser/dist/admin/admin.html`. La primera vez resulta necesario introducir admin como nombre de usuario y contraseña.

![OxOOL Admin Console](img/OxOOL-ConsolaAdministracion.png)

La clave se puede modificar desde el menu System ubicado arriba a la derecha. En caso de no querer utilizarla, se puede deshabilitarla completamente editando el archivo /etc/oxool/oxoolwsd.xml  
En la sección

```bash
<admin_console desc="Web admin console settings.">
<enable desc="Enable the admin console functionality" type="bool" default="true">true</enable>
<enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam>
<username desc="The username of the admin console. Ignored if PAM is enabled.">admin</username>
<password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or oxoolconfig to set up a secure password.">admin</password>
<logging desc="Log admin activities irrespective of logging.level">
<admin_login desc="log when an admin logged into the console" type="bool" default="true">true</admin_login>
<metrics_fetch desc="log when metrics endpoint is accessed and metrics endpoint authentication is enabled" type="bool" default="true">true</metrics_fetch>
<monitor_connect desc="log when external monitor gets connected" type="bool" default="true">true</monitor_connect>
<admin_action desc="log when admin does some action for example killing a process" type="bool" default="true">true</admin_action>
</logging>
</admin_console>
```

El archivo `/etc/oxool/oxoolwsd.xml` contiene distintos parámetros que nos puede interesar modificar y/o ajustar. Por ejemplo, los idiomas soportados, la ruta del archivo de registro o la lista de host permitidos, entre otros.

![OxOOL Admin Console](img/OxOOL-AcercaDe.png)

Con información de [**docs.ossii.com.tw**](https://docs.ossii.com.tw/books/oxoffice-online-%E6%8A%80%E8%A1%93%E6%89%8B%E5%86%8A)