Instalando o ONLYOFFICE Docs Enterprise Edition no Debian e Ubuntu

Introdução

A Enterprise Edition permite que você instale o ONLYOFFICE Docs em seu servidor local e integre os editores online com a plataforma de colaboração ONLYOFFICE ou com outros sistemas populares (veja a lista detalhada de recursos). Este guia demonstrará como instalar a versão Linux do ONLYOFFICE Docs Enterprise Edition na sua máquina.

Requisitos de sistema

• CPU: Processador Dual Core de 2 GHz ou superior
• RAM: mínimo de 2 GB, mas depende do SO host. Quanto mais, melhor
• HDD: pelo menos 40 GB de espaço livre
• SWAP: pelo menos 4 GB, mas depende do SO host. Quanto mais, melhor
• SO: Debian, Ubuntu de 64 bits ou outra distribuição compatível com kernel versão 3.13 ou posterior
• Requisitos adicionais
  • PostgreSQL: versão 12.9 ou posterior
  • NGINX: versão 1.3.13 ou posterior
  • libstdc++6: versão 4.8.4 ou posterior
  • Redis: versão 4 ou posterior
  • RabbitMQ

Instalando o ONLYOFFICE Docs

A instalação em distribuições baseadas em Debian também exige a presença do libstdc++6, NGINX e PostgreSQL no sistema.

Todas as instruções necessárias para a instalação desses componentes e de suas dependências podem ser encontradas em seus sites oficiais.

Existem outras dependências que são instaladas junto com o ONLYOFFICE Docs:

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

Essas dependências são instaladas automaticamente quando você utiliza o Ubuntu 14.04 LTS ou posterior. Distribuições mais antigas podem exigir a instalação manual.

Instalando dependências

O ONLYOFFICE Docs utiliza o NGINX e o PostgreSQL como banco de dados. As dependências encontradas no repositório do sistema serão instaladas automaticamente durante a instalação do ONLYOFFICE Docs usando o comando apt-get install.

Instalando e configurando o PostgreSQL

Instale a versão do PostgreSQL incluída na sua versão do Ubuntu:

sudo apt-get install postgresql

observação

Se você deseja instalar outra versão do PostgreSQL a partir do repositório do PostgreSQL, consulte a documentação oficial do PostgreSQL para obter mais detalhes.

Após a instalação do PostgreSQL, crie o banco de dados e o usuário do PostgreSQL:

observação

O usuário do banco de dados deve se chamar onlyoffice. Você pode especificar qualquer senha.

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

Instalando o Redis

sudo apt-get install redis-server

Instalando o RabbitMQ

sudo apt-get install rabbitmq-server

Instalando o NGINX

sudo apt-get install nginx

observação

No Ubuntu 18.04, instale o pacote nginx-extras em vez disso: sudo apt-get install nginx-extras

Importante

Se você planeja executar o ONLYOFFICE Docs na porta 80, desative agora o site padrão do NGINX. Caso contrário, o ONLYOFFICE Docs pode não funcionar corretamente. Para isso, execute os seguintes 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

Dependendo de como o NGINX foi instalado, um dos dois primeiros comandos pode informar que o arquivo não existe. Você pode ignorar essa mensagem com segurança.

observação

Distribuições do Ubuntu anteriores à 14.04 LTS podem exigir a instalação de outras dependências.

Alterando a porta padrão do ONLYOFFICE Docs

Por padrão, o ONLYOFFICE Docs escuta as conexões de entrada na porta 8083. A partir da versão 4.3, você pode alterar a porta do ONLYOFFICE Docs se planeja usar outra em vez da padrão.

observação

Se você for alterar a porta padrão, certifique-se de que ela esteja aberta para conexões de entrada/saída. Veja a lista completa de portas usadas pelo ONLYOFFICE Docs.

Para isso, você precisará alterar a porta padrão no sistema debconf executando o comando:

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

Substitua <PORT_NUMBER> no comando acima pelo número da porta desejada.

observação

Se você definir a porta como 80, certifique-se de ter desativado o site padrão do NGINX, conforme descrito na seção Instalando o NGINX.

Aviso

Se você quiser alterar o protocolo do ONLYOFFICE Docs para HTTPS, não altere a porta para 443; em vez disso, utilize este guia.

Existem opções adicionais que podem ser usadas na instalação do ONLYOFFICE Docs. Leia esta seção para obter mais informações sobre elas.

Depois disso, você pode continuar com a instalação do ONLYOFFICE Docs.

Instalando o ONLYOFFICE Docs

Adicione a chave 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

Adicione o repositório do 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

observação

Embora o pacote APT seja criado para o Debian Squeeze, ele é compatível com vários derivados do Debian (incluindo o Ubuntu), o que significa que você pode usar o mesmo repositório em todas essas distribuições.

Ao instalar o ONLYOFFICE Docs no Debian, adicione o componente contrib ao /etc/apt/sources.list. Para saber mais, consulte a documentação do Debian.

Atualize o cache do gerenciador de pacotes:

sudo apt-get update

Instale as mscorefonts:

sudo apt-get install ttf-mscorefonts-installer

Instale o ONLYOFFICE Docs:

sudo apt-get install onlyoffice-documentserver-ee

observação

Durante a instalação, será solicitado que você informe a senha do usuário onlyoffice do PostgreSQL. Digite a senha onlyoffice que você especificou ao configurar o PostgreSQL.

Depois disso, o ONLYOFFICE Docs será executado como um processo. O pacote será atualizado como qualquer outro pacote deb.

Agora você pode digitar http://localhost:8083 na barra de endereços do navegador para abrir a página de boas-vindas do ONLYOFFICE Docs, onde encontrará mais instruções sobre como ativar os exemplos de documentos ou integrar os editores online ao seu aplicativo web usando a API fornecida.

Executando o ONLYOFFICE Docs usando HTTPS

Na maioria dos casos, acessar o portal pelo protocolo HTTPS é muito mais seguro do que pelo HTTP, usado por padrão. Você pode executar facilmente o ONLYOFFICE Docs usando uma conexão segura. Veja os detalhes aqui para saber mais sobre como fazer isso.

Registrando a sua versão Enterprise Edition

Se você comprou a Enterprise Edition e recebeu o arquivo license.lic, você pode colocá-lo na sua instalação para obter a versão completa do software.

Se você usa uma distribuição Linux baseada em Debian, o arquivo license.lic deve ser colocado na seguinte pasta:

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

Depois disso, a sua versão da Enterprise Edition ficará registrada e com todos os recursos.

Informações adicionais: mais opções para a instalação do ONLYOFFICE Docs

A instalação do ONLYOFFICE Docs permite o uso de mais opções do debconf, que podem ser muito úteis caso você planeje instalá-lo em mais de um servidor ou em outros casos.

Essas opções incluem:

• Opções do banco de dados PostgreSQL

  • Defina o endereço do host do banco de dados PostgreSQL (substituindo <DB_HOST> pelo endereço real do servidor PostgreSQL instalado):

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

  • Defina o nome de usuário do banco de dados PostgreSQL (substituindo <DB_USER> pelo nome real do usuário com os direitos apropriados no banco de dados PostgreSQL):

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

  • Defina a senha do usuário do banco de dados PostgreSQL (substituindo <DB_PASSWORD> pela senha real do usuário com os direitos apropriados no banco de dados PostgreSQL):

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

  • Defina o nome do banco de dados PostgreSQL (substituindo <DB_NAME> pelo nome real do banco de dados PostgreSQL):

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

• Opções do Redis

  • Defina o endereço do host do Redis (substituindo <REDIS_HOST> pelo endereço real do Redis instalado):

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

• Opções do RabbitMQ

  • Defina o endereço do host do RabbitMQ (substituindo <RABBITMQ_HOST> pelo endereço real do RabbitMQ instalado):

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

  • Defina o nome de usuário do RabbitMQ (substituindo <RABBITMQ_USER> pelo nome real do usuário com os direitos apropriados no RabbitMQ):

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

  • Defina a senha do usuário do RabbitMQ (substituindo <RABBITMQ_PWD> pela senha real do usuário com os direitos apropriados no RabbitMQ):

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

• Opções JWT

  Você pode usar o debconf-set-selections para impedir que os valores personalizados no arquivo local.json sejam substituídos após a atualização do ONLYOFFICE Docs.

  • Ative os JSON Web Tokens (JWT):

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

  • Defina uma chave secreta JWT substituindo <JWT_SECRET> pelo seu próprio valor:

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