Script intended to build & install Office Online on moderns Ubuntu and Debian systems.
Written by: Marc C., @DmDS & Subhi H.
- GNUv3 Licence
- Requirements
- Notice
- Default Installation
- Default Installation
- Idempotence
- Parameters
- Debug
- Nota Bene
This script is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This script is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
- The script requires a minimum of 3.7 GB of RAM installed to run.
- First installation requires about 13 GB of available space on the system.
THE FIRST INSTALLATION WILL TAKE A VERY, VERY LONG TIME!
... So take your favorite mug, and make yourself a nice cup of coffee/tea while you go watching your favorites movies. 😄
You might see errors during the installation, just ignore them.
It will install libreoffice in /opt/libreoffice, Poco in /opt/poco and onlineOffice in /opt/cool
Your can manage your service using systemd: systemctl start|stop|restart|status coolwsd.service
Since v2.4 the script accept the following usage:
officeonline-install.sh [-h][-c file|variable definition][-f lo|poco|cool][-l VERSION][-o COMMIT][-p VERSION]
-
Options:
-
-c, --config /a/configuration/file|variable=valueLoad a script configuration file OR directly a variable and its value to override it from the loaded configuration. This option can be repeated.
-
-f, --force lo|poco|coolSpecify a component to build anyway. Support some aliases for LibreOffice core and Libreoffice Online This option can be repeated.
-
-h, --helpdisplay this help and exit
-
-
Thoses options have been kept for backward compatibility and may be removed in future releases:
-
-l, --libreoffice_commit)=COMMITLibreoffice COMMIT - short/full hash Equivalent of
-c lo_src_commit=COMMIT -
-o, --libreoffice_online_commit)=COMMITLibreoffice Online COMMIT - short/full hash. Equivalent of
-c cool_src_commit=COMMIT -
-p, --poco_version)=VERSIONPoco Version Equivalent of
-c poco_version=VERSION
-
Since v2.4 the script search for an external configuration file that will override parts or all the default configuration.
The script search for the file named officeonline-install.cfg in the following places in that order:
- The file specified from the command line with the
--configoption. It can be of any name. - The current working directory except when it's the script's directory.
- The user's home directory
- The /etc/coolwsd/ directory
- The script's directory
Only the first file found is loaded.
INFO: A fully commented configuration file is in the script's directory available as a template or an example.
Since v2.1, it is possible to choose a Set. A set is an duo of branches from both LibreOffice core and online git repositories that are known to create a smooth LO-Online experience.
By default latest version available of collabora
Its possible to pin exact version of the services used, like this:
./officeonline-install.sh -l 5.3.1.2 -c cool_src_commit=47c01440ba794d2ea953d6ac1b80f7e42769f4e -c poco_version=1.7.8p2
There is also a help:
./officeonline-install.sh -h
This script has been made idempotent: Only the required action will be executed if it is run several times on the same System in order to get to the expected state.
Example: when updating LibreOffice online to the latest version, LibreOffice compilation and installation steps will not be run as it is already installed.
These parameters describes the expected state of the system regarding LibreOffice Online installation.
The installation can be tuned to your needs by changing these variables.
Affect the whole build.
distrib_name: A name for a list of build options for LibreOffice. The distribution is a file that may be created from scratch and changed by the script 'LibreOfficeOnline' by defaultallowed_domains: Space separated list of domains allowed to use the LibreOffice-Online service. dots escaping is processed by the script.- Note: Removing domains from the configuration file is not supported. Unwanted domains still need to be removed manually in the configuration file.
/etc/coolwsd/coolwsd.xmlby default.
- Note: Removing domains from the configuration file is not supported. Unwanted domains still need to be removed manually in the configuration file.
Affect how the script chooses the best set of commits to use for core and online.
set_name: used to locate branchs folders in the libreoffice project. 'collabora' by defaultset_core_regex: regulax expression used to find the branch name for core 'cp-' by default.set_online_regex: regulax expression used to find the branch name for online 'collabora-online' by default.set_versioncan be used if both branch name contains a common version number. Else, latest version available for each project will be used. empty by default
For Idempotence, LO's status is defined by its sources' commit id.
lo_dir: The installation directory for Lo. `/opt/cool by default.lo_forcebuild: A boolean to override idempotence and force LibreOffice compilation and installation.falseby default.lo_configure_opts: comma separated list of build options. Added to the distro. `` by default. For experts only! Each update of the sources by the script will trigger a lO compilation & installationlo_src_repo: the Git repository "https://github.com/LibreOffice/core.git"lo_src_branch: an existing branch name. It pull the latest Tag availablemasterby default- One of the 2:
lo_src_commit: the id of a git commit in the selected branch.emptyby defaultlo_src_tag: a tag in the selected branch.emptyby default
If more than one is defined, a choice is made:
- choice precedence: Commit over tag
Poco is an opensource C++ library for network based project. It is required by LibreOffice Online.
poco_version: a specific version to download, compile and install. Fetch the latest stable release from https://pocoproject.org/ by default.poco_dir: The installation directory for poco./opt/poco-${poco_version}-allby default.poco_forcebuild: A boolean to override idempotence and force POCO compilation and installation.falseby default.
Cool (Collabora Online) in a project to bring a opensource Office solution for web editing.
cool_dir: The installation directory for Cool./opt/coolby default.cool_forcebuild: A boolean to override idempotence and force LibreOffice Online compilation and installation.falseby default.
For Idempotence, Cool's status is defined by its sources' commit id.
Each update of the sources by the script will trigger a cool compilation & installation
- the Git repository:
cool_src_repo"https://github.com/LibreOffice/online.git" - One of the 3:
cool_src_branch: an existing branch name. It pull the latest commit availablemasterby defaultcool_src_commit: the id of a git commit.emptyby defaultcool_src_tag: a tag in the git repository.emptyby default
If more than one is defined, a choice is made:
- choice precedence: Commit over tag over branch
The following parameters are options passed to the configuration script before compilation.
cool_logfile:/var/log/coolwsd.logcool_maxdoc: Maximum number of simultaneously opened documents for Cool.100by default.cool_maxcon: Maximum number of simultaneously opened connections for Cool.200by default.cool_configure_opts: comma separated list of build options. Added to the distro. Empty by default. For experts only!cool_prefix: The base directory from where the directory tree is generated. Used to install the application '/usr' by defaultcool_sysconfdir: The base directory from where the application's is located '/etc' by defaultcool_localstatedir: The base directory from where the application's state files are located. '/var' by default
Can be enabled by running sudo ./officeonline-install.sh -c cool_configure_opts='--enable-debug' -f cool
or
add --enable-debug to cool_configure_opts='' in officeonline-install.cfg before compiling. Don't forget to remove the #
Change filesystem allow="false" to "true" in /opt/cool/coolwsd.xml
Enabling debug can pose a security risk. Use it only for testing.
-
All the script's output is logged in the folder
$PWD/YYYYMMDD-HHmm_officeonline-install. whereYYYYMMDD-HHmmis the date at the minute the script as been launched. -
Maxdoc&Maxconare built-in limitations in WebSocket and intended to guarantee a good QoS and limit resources consumption on the host. If you intend to change this parameters, take into account that 1 doc opened is around 20MB of RAM used. -
Default parameters are values chosen by the maintainers of this script and not default values used by the softwares compiled here.
-
If you ever need support for using this script, try to run it first with all parameters at default to get a reference point.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent