Articles with the tag:
Close
Changelog
Close
Try in the cloud
Help Center
ONLYOFFICE Docs Community Edition for Linux

Compiling ONLYOFFICE Docs for a local server

ONLYOFFICE Docsv6.4 ONLYOFFICE Docs changelog

Version 6.4.1

Release date: 09/28/2021

Version 6.4.0

Release date: 08/26/2021

Version 6.3.2

Release date: 08/10/2021

Version 6.3.1

Release date: 06/08/2021

Version 6.3.0

Release date: 05/20/2021

Version 6.2.2

Release date: 04/19/2021

Version 6.2.1

Release date: 03/31/2021

Version 6.2.0

Release date: 03/01/2021

Version 6.1.1

Release date: 01/28/2021

Version 6.1.0

Release date: 12/02/2020

Version 6.0.2

Release date: 11/12/2020

Version 6.0.1

Release date: 10/28/2020

Version 6.0.0

Release date: 10/14/2020

Version 5.6.5

Release date: 09/21/2020

Version 5.6.4

Release date: 09/08/2020

Version 5.6.3

Release date: 08/17/2020

Version 5.6.2

Release date: 08/07/2020

Version 5.6.1

Release date: 08/05/2020

Version 5.6.0

Release date: 07/29/2020

Version 5.5.3

Release date: 05/22/2020

Version 5.5.1

Release date: 04/09/2020

Version 5.5.0

Release date: 03/05/2020

Version 5.4.2

Release date: 11/27/2019

Version 5.4.1

Release date: 10/02/2019

Version 5.4.0

Release date: 09/03/2019

Version 5.3.4

Release date: 07/16/2019

Version 5.3.2

Release date: 06/24/2019

Version 5.3.1

Release date: 06/06/2019

Version 5.3.0

Release date: 05/28/2019

Version 5.2.8

Release date: 02/05/2019

Version 5.2.7

Release date: 01/16/2019

Version 5.2.6

Release date: 12/25/2018

Version 5.2.4

Release date: 12/12/2018

Version 5.2.3

Release date: 10/31/2018

Version 5.2.2

Release date: 10/05/2018

Version 5.2.0

Release date: 09/28/2018

Version 5.1.5

Release date: 07/18/2018

Version 5.1.4

Release date: 05/24/2018

Version 5.1.3

Release date: 04/27/2018

Version 5.1.2

Release date: 04/11/2018

Version 5.1.1

Release date: 04/05/2018

Version 5.1.0

Release date: 03/28/2018

Version 5.0.7

Release date: 01/16/2018

Version 5.0.6

Release date: 12/11/2017

Version 5.0.5

Release date: 11/28/2017

Version 5.0.4

Release date: 11/14/2017

Version 5.0.3

Release date: 11/02/2017

Version 5.0.2 SaaS only

Release date: 10/13/2017

Version 5.0.1 SaaS only

Release date: 10/05/2017

Version 5.0.0 SaaS only

Release date: 09/23/2017

Version 4.4.4

Release date: 09/13/2017

Windows-only release

See changelog on GitHub

Version 4.4.3

Release date: 08/14/2017

Version 4.4.2

Release date: 07/24/2017

Version 4.4.1

Release date: 07/05/2017

Version 4.3.6

Release date: 06/14/2017

Version 4.3.5

Release date: 06/05/2017

Version 4.3.4

Release date: 05/16/2017

Version 4.3.3

Release date: 04/28/2017

Version 4.3.2

Release date: 04/17/2017

Version 4.3.1

Release date: 04/06/2017

Version 4.3.0

Release date: 04/03/2017

Version 4.2.11

Release date: 03/13/2017

Version 4.2.10

Release date: 02/20/2017

Version 4.2.9

Release date: 02/14/2017

Version 4.2.8

Release date: 02/06/2017

Version 4.2.7

Release date: 02/01/2017

Version 4.2.5

Release date: 01/16/2017

Version 4.2.4

Release date: 01/09/2017

Version 4.2.3

Release date: 12/23/2016

Version 4.2.2

Release date: 12/21/2016

Version 4.2.1

Release date: 12/06/2016

Version 4.2.0

Release date: 12/01/2016

Version 4.1.8

Release date: 11/03/2016

Version 4.1.7

Release date: 11/01/2016

Version 4.1.6

Release date: 10/26/2016

Version 4.1.5

Release date: 10/13/2016

Version 4.1.4

Release date: 10/07/2016

Version 4.1.3

Release date: 09/28/2016

Version 4.1.2

Release date: 09/22/2016

Version 4.0.3

Release date: 08/04/2016

Version 4.0.2

Release date: 08/03/2016

Introduction

ONLYOFFICE Docs is an online office suite comprising viewers and editors for texts, spreadsheets and presentations, fully compatible with Office Open XML formats: .docx, .xlsx, .pptx and enabling collaborative editing in real time.

You can easily compile ONLYOFFICE Docs from source codes and deploy the solution on your local server using the specially designed build_tools. The build_tools allow to automatically get and install all the components necessary for the compilation process, all the dependencies required for the ONLYOFFICE Docs correct work, as well as to get the latest version of ONLYOFFICE Docs source code and build all its components.

Important! We can only guarantee the correct work of the products built from the master branch.

System requirements

Hardware

  • CPU
    dual core 2 GHz or better
  • RAM
    2 GB or more
  • HDD
    at least 40 GB of free space
  • Additional requirements
    at least 4 GB of swap

Software

  • OS
    64-bit Ubuntu 14.04
The solution has been tested on Ubuntu 14.04. Other distributions might require some specific actions which are not described here.

Installing dependencies

You might need to install Python and Git if they are not yet installed on your computer. This can be done using the following command:

sudo apt-get install -y python git

Building ONLYOFFICE Docs source code

  1. Clone the build_tools repository:
    git clone https://github.com/ONLYOFFICE/build_tools.git
    
  2. Go to the build_tools/tools/linux directory:
    cd build_tools/tools/linux
    
  3. Run the automate.py script specifying the server parameter to compile the ONLYOFFICE Docs:
    ./automate.py server
    
    If you run the script without any parameters, this will build ONLYOFFICE Docs alongside with Document Builder and Desktop Editors.
    ./automate.py
    
    If necessary, you can build several products at once by running the script with the parameters corresponding to the necessary products. To learn more about compiling Document Builder you can read this article. To learn more about compiling Desktop Editors please refer to this article.

Wait while the script is being executed. Depending on your computer capabilities, this process may take considerable time. For example, this takes 3 hours at least on Intel Core i7-7700.

The script will compile all the dependencies and components which are a part of ONLYOFFICE Docs.

The built ONLYOFFICE Docs will be available in the ../../out/linux_64/onlyoffice/documentserver/ directory.

Installing and configuring NGINX, PostgreSQL and RabbitMQ

ONLYOFFICE Docs uses NGINX as a web server and PostgreSQL as a database. RabbitMQ is also required for ONLYOFFICE Docs to work correctly.

Installing and configuring NGINX
  1. Install NGINX:
    sudo apt-get install nginx
    
  2. Disable the default website:
    sudo rm -f /etc/nginx/sites-enabled/default
    
  3. Now you need to set up the new website. To do that create the /etc/nginx/sites-available/onlyoffice-documentserver file with the following contents:
    map $http_host $this_host {
      "" $host;
      default $http_host;
    }
    map $http_x_forwarded_proto $the_scheme {
      default $http_x_forwarded_proto;
      "" $scheme;
    }
    map $http_x_forwarded_host $the_host {
      default $http_x_forwarded_host;
      "" $this_host;
    }
    map $http_upgrade $proxy_connection {
      default upgrade;
      "" close;
    }
    proxy_set_header Host $http_host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $proxy_connection;
    proxy_set_header X-Forwarded-Host $the_host;
    proxy_set_header X-Forwarded-Proto $the_scheme;
    server {
      listen 0.0.0.0:80;
      listen [::]:80 default_server;
      server_tokens off;
      rewrite ^\/OfficeWeb(\/apps\/.*)$ /web-apps$1 redirect;
      location / {
        proxy_pass http://localhost:8000;
        proxy_http_version 1.1;
      }
      location /spellchecker/ {
        proxy_pass http://localhost:8080/;
        proxy_http_version 1.1;
      }
    }
  4. Add the symlink to the newly created website to the /etc/nginx/sites-available directory:
    sudo ln -s /etc/nginx/sites-available/onlyoffice-documentserver /etc/nginx/sites-enabled/onlyoffice-documentserver
    
  5. And restart NGINX to apply the changes:
    sudo nginx -s reload
    
Installing and configuring PostgreSQL

Install PostgreSQL using the following command:

sudo apt-get install postgresql

Once PostgreSQL is installed, run the following commands to create the PostgreSQL database and user:

The created database must have onlyoffice both for user and password.
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice;"
sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH password 'onlyoffice';"
sudo -i -u postgres psql -c "GRANT ALL privileges ON DATABASE onlyoffice TO onlyoffice;"

Run the following command to configure the database:

psql -hlocalhost -Uonlyoffice -d onlyoffice -f ../../out/linux_64/onlyoffice/documentserver/server/schema/postgresql/createdb.sql
Upon that, you will be asked to provide a password for the onlyoffice PostgreSQL user. Please enter the onlyoffice password.
Installing RabbitMQ

Install RabbitMQ using the following command:

sudo apt-get install rabbitmq-server
Generate fonts data
cd out/linux_64/onlyoffice/documentserver/
mkdir fonts
LD_LIBRARY_PATH=${PWD}/server/FileConverter/bin server/tools/allfontsgen \
  --input="${PWD}/core-fonts" \
  --allfonts-web="${PWD}/sdkjs/common/AllFonts.js" \
  --allfonts="${PWD}/server/FileConverter/bin/AllFonts.js" \
  --images="${PWD}/sdkjs/common/Images" \
  --selection="${PWD}/server/FileConverter/bin/font_selection.bin" \
  --output-web='fonts' \
  --use-system="true"
Generate presentation themes
cd out/linux_64/onlyoffice/documentserver/
LD_LIBRARY_PATH=${PWD}/server/FileConverter/bin server/tools/allthemesgen \
  --converter-dir="${PWD}/server/FileConverter/bin"\
  --src="${PWD}/sdkjs/slide/themes"\
  --output="${PWD}/sdkjs/common/Images"

Running ONLYOFFICE Docs

All ONLYOFFICE Docs components run as foreground processes. Thus you need separate terminal consoles to run them or specific tools which will allow to run foreground processes in background mode.
  1. Start the FileConverter service:
    cd out/linux_64/onlyoffice/documentserver/server/FileConverter
    
    LD_LIBRARY_PATH=$PWD/bin NODE_ENV=development-linux NODE_CONFIG_DIR=$PWD/../Common/config ./converter
    
  2. Start the SpellChecker service:
    cd out/linux_64/onlyoffice/documentserver/server/SpellChecker
    
    NODE_ENV=development-linux NODE_CONFIG_DIR=$PWD/../Common/config ./spellchecker
    
  3. Start the DocService service:
    cd out/linux_64/onlyoffice/documentserver/server/DocService
    
    NODE_ENV=development-linux NODE_CONFIG_DIR=$PWD/../Common/config ./docservice
    
Download Host on your own server Available for
Docker, Windows and Linux
You Might Also Like This:
Close