+++ authors = [ "Collabora", ] title = "Build Collabora Online" date = "2020-12-01" home_pos = "1" description = "Step-by-step build instructions" tags = [ "build", "make", ] images = [ "build-code.jpg", ] type = "sidebar" layout = "sidebar" showimage = false +++

Are you interested in contributing but don't know where to start? Head over to the documentation or start by following these step-by-step instructions and build CODE from scratch.

Build CODE

Build Collabora Online Development Edition. Choose your operating system or opt for using Gitpod (hack, build, debug and run entirely using a web-browser) from the list below for straightforward instructions to get you going quickly. If you are a seasoned developer with commit access, or just feeling extraordinarily brave, feel free to follow the general instructions.

Gitpod {#build-code-on-gitpod}

On top of our daily LibreOffice core archives, we have also added integration support for Gitpod, a cloud based development environment. Now you can start hacking Collabora Online (COOL) in under ~5 minutes!

Steps to quick start:

Sign-up on Gitpod.io with your GitHub account
Install the proper extension for your browser
Go to COOL repo
Click on the green Gitpod button near the top of the GitHub repo page

{{< figure src="/images/gitpod-button-onGitHub.png" alt="GitPod green button on GitHub">}}

You should be redirected to gitpod.io where you can set your workspace settings. Please choose large container:

{{< figure src="/images/gitpod-new-workspace.png" alt="GitPod.io new workspace">}}

Make sure your browser is not blocking windows/tabs from opening from the gitpod workspace URL (maybe add *.gitpod.io to your browser's whitelist)
VNC tab will open automatically if not just click on the left icon Remote explorer and click 6080. You will see a tab completely black, that's normal.

{{< figure src="/images/gitpod-screenshot-COOL.png" title="Gitpod, your development environment for Collabora Online on the cloud">}}

Wait for a few minutes, and you will have a full development environment with COOL already cloned & built, ready-to-start/develop.

{{< figure src="/images/gitpod-screenshot-COOL-splitterminal.png" title="The left pane will automatically start to build the software for you. The right waits for the 9980 port to be available and displays interesting comments">}}

The GitPod tasks will run automatically and further instructions will be printed out right in the terminal
After the build finishes (left terminal pane) you will see links. Copy the URL ending with: hello-world.odt
In the right terminal pane execute the following: firefox [paste copied URL here] or /usr/bin/chromium [paste copied URL here]
Now head over to the web browser tab where the VNC is opened, you will see Firefox/Chromium opening there, maximize and have fun.
You can also run cypress tests via GitPod. To do so, please prepend CYPRESS_BROWSER="/usr/bin/chromium" ("firefox" can also be used). Example:
- cd cypress_test/
- CYPRESS_BROWSER="/usr/bin/chromium" make check for every test or CYPRESS_BROWSER="/usr/bin/chromium" make check-desktop spec=impress/scrolling_spec.js for one specific test on desktop
- More info at https://github.com/CollaboraOnline/online/blob/master/cypress_test/README
Don’t forget to fork the main repo
And set the remote address in .git/config to point to your fork’s address with this command:

git remote set-url origin https://github.com/PUT-YOUR-GITHUB-USERNAME-HERE/online.git

Happy hacking! : )

First published on Collabora Online Community Roundup #2

If you are using VS Code as your IDE and want to run code in your local VS Code with local ports, follow these steps:

Open Gitpod and navigate to the top left option.
Select Gitpod: Open in VS Code.
Install the following extensions in your VS Code: Gitpod, Remote - SSH, Remote - SSH: Editing Configuration Files, and Remote Explorer.
Configure your SSH key in VS Code.
Once everything is set up, type make run. This will allow you to access the hosted port on your local machine.

openSUSE {#build-code-on-opensuse}

The instructions below have been prepared for and tested on openSUSE Leap 15.3. You might need to do small adjustments for other releases.

Dependencies

We need LibreOffice core, POCO library and several other libraries and tools to build CODE. Open a terminal and follow the steps below.

# For Leap 15.5
zypper ar http://download.opensuse.org/repositories/devel:/libraries:/c_c++/15.5/devel:libraries:c_c++.repo

If this is fresh instalation it might be worth install devel-basis pattern: Minimal set of tools for compiling and linking applications. It will bring in things like git, gcc, etc.

sudo zypper install -t pattern devel_basis

Now go ahead and install the following packages

zypper in poco-devel libcap-progs python3-polib libcap-devel npm libtool cppunit-devel pam-devel python3-lxml chromium

# If you are using Leap 15.4 please install this aditional compatability library
zypper in libpng16-compat-devel

LibreOffice

{{% common-build-commands section="code-needs-lo-wget" lotar="core-co-24.04-assets.tar.gz" %}}

Building CODE

You need to clone it, run autoconf/automake, configure and build using the GNU make. Before moving on, fork the repo if you haven't done that yet.

Now clone the forked repo: {{% common-build-commands section="clone-online" %}}

Fedora {#build-code-on-fedora}

The instructions below have been prepared for and tested on Fedora 37. You might need to do small adjustments for Fedora-based distributions.

Dependencies

We need LibreOffice core, POCO library and several other libraries and tools to build CODE.

Open a terminal and follow the steps below:

sudo dnf install poco-devel gcc gcc-c++ python3-polib python3-lxml \
                 libtool libstdc++-devel libpng libpng-devel \
                 cppunit-devel nodejs-devel chromium \
                 libzstd-devel libcap-devel pam-devel

LibreOffice

{{% common-build-commands section="code-needs-lo-wget" lotar="core-co-24.04-assets.tar.gz" %}}

Building CODE

You need to clone it, run autoconf/automake, configure and build using the GNU make. Before moving on, fork the repo if you haven't done that yet.

Now clone the forked repo: {{% common-build-commands section="clone-online" %}}

Arch {#build-code-on-arch}

The instructions below have been prepared for and tested on Manjaro 21.2.3. You might need to do small adjustments for Arch and/or other Arch-based distributions.

Dependencies

We need LibreOffice core, POCO library and several other libraries and tools to build CODE.

Open a terminal and follow the steps below:

sudo pacman -Syu libcap libcap-ng lib32-libcap libpng poco cppunit nodejs npm chromium python-lxml

Additionally you will need to install python-polib. You can do this using pip (as below) or using the python-polib AUR package

sudo pacman -Syu python-pip
sudo pip install polib

LibreOffice

{{% common-build-commands section="code-needs-lo-wget" lotar="core-co-24.04-assets.tar.gz" %}}

Building CODE

You need to clone it, run autoconf/automake, configure and build using the GNU make. Before moving on, fork the repo if you haven't done that yet.

Now clone the forked repo: {{% common-build-commands section="clone-online" %}}

Debian {#build-code-on-debian}

The instructions below have been prepared for and tested on Debian GNU/Linux 11 (bullseye). You might need to do small adjustments for other releases.

Note: Sometimes Debian comes without sudo preinstalled. If you do not have sudo, you will need to run apt install -y sudo as root. It is not good enough to only run the commands which require sudo below as root, as sudo is also run during make

Dependencies

We need LibreOffice core, POCO library and several other libraries and tools to build CODE. Open a terminal and follow the steps below.

Lets start by installing the dialog package, which will be needed while installing some of the other packages:

sudo apt install -y dialog

Now install the rest of the required packages:

sudo apt install -y libpoco-dev python3-polib libcap-dev npm \
                    libpam-dev wget git build-essential libtool \
                    libcap2-bin python3-lxml libpng-dev libcppunit-dev \
                    pkg-config fontconfig chromium

LibreOffice

{{% common-build-commands section="code-needs-lo-wget" lotar="core-co-24.04-assets.tar.gz" %}}

Building CODE

You need to clone it, run autoconf/automake, configure and build using the GNU make. Before moving on, fork the repo if you haven't done that yet.

Now clone the forked repo: {{% common-build-commands section="clone-online" %}}

Ubuntu {#build-code-on-ubuntu}

The instructions below have been prepared for and tested on Ubuntu 20.04 LTS. You might need to do small adjustments for other releases.

Dependencies

We need LibreOffice core, POCO library and several other libraries and tools to build CODE. Open a terminal and follow the steps below.

Lets start by installing the dialog package, which will be needed while installing some of the other packages:

sudo apt install -y dialog

Now install the rest of the required packages:

sudo apt install -y libpoco-dev python3-polib libcap-dev npm \
                    libpam-dev libzstd-dev wget git build-essential libtool \
                    libcap2-bin python3-lxml libpng-dev libcppunit-dev \
                    pkg-config fontconfig snapd chromium-browser

Note: Chomium is needed and used in cypress tests. Ubuntu has no chromium deb packages in its repositories, only a dummy pacakge that points to the respective snap. Probably best to make sure you have snapd installed and install chromium-browser which in turn will install the snap package.

LibreOffice

{{% common-build-commands section="code-needs-lo-wget" lotar="core-co-24.04-assets.tar.gz" %}}

Building CODE

You need to clone it, run autoconf/automake, configure and build using the GNU make. Before moving on, fork the repo if you haven't done that yet.

Now clone the forked repo: {{% common-build-commands section="clone-online" %}}

Build CODE & LO {#build-code-n-lo}

Dependencies

The CODE must be built on Linux, and you need the following:

LibreOffice
- Either build LibreOffice from source, or download a daily built archive (see below)
Poco library: http://pocoproject.org/
- Either use the package from your distro, or build it yourself, ideally 1.10.1 or later
libpng, libcap-progs, libtool, automake, autoconf, pkg-config, sudo, pam
- Use the packages from your distro

You may also want to have the following optional dependencies:

Chromium
- Needed for running cypress tests
The lxml and polib libraries for python
- Needed for building javascript
- These can both be installed via pip or your distro's packages
Cppunit
- Needed for unit tests
Node.js
- Needed for building the JS parts (not needed if you build them on another linux machine)

LibreOffice

CODE needs LibreOffice to be built to run. You have two options to meet this requirement: either by building it locally (Option A - recommended), or by downloading a daily built archive (Option B - quick & dirty) which contains only the absolutely necessary pieces. If you are working only on the online side, without doing any code-level changes on the LibreOffice core, or you just want to quickly get going to do some small fixes, you may prefer the second way.

Option A - Build LibreOffice locally (Recommended)

The build process for LibreOffice is described on their wiki. However, a few modifications are needed in order to support building CODE.

https://wiki.documentfoundation.org/Development/BuildingOnLinux

Install the dependencies. The lists of dependencies and commands for various distributions of Linux are avialable on the LibreOffice Wiki linked above.

Clone the repository and switch to the Collabora Online branch: {{% common-build-commands section="clone-lo" lobranch="co-24.04" %}}

Configure and build, adding the following configuration options to autogen.sh or autogen.input:

./autogen.sh --with-distro=CPLinux-LOKit --without-package-format

make -j $(nproc)

You can expect this process to take at least an hour or two the first time, possibly more depending on your machine and your internet connection. Subsequent builds will be faster.

Option B - Download a Daily-Built Archive of LibreOffice (Quick & Dirty)

{{% common-build-commands section="code-needs-lo-wget" lotar="core-co-24.04-assets.tar.gz" %}}

You should now have two new directories extracted: instdir and include. You will use the locations of these directories for the configure parameters in the following steps.

Building CODE

You need to clone it, run autoconf/automake, configure and build using the GNU make: {{% common-build-commands section="clone-online" %}} {{% common-build-commands section="build-online" %}}

You can also add extra flags to customize your build:

If you built POCO from source, add --with-poco-includes=<POCODIRECTORY>/include --with-poco-libs=<POCODIRECTORY>/lib
Add --enable-silent-rules to create less verbose build output
Add --enable-cypress to enable tests which use a browser (requires Chromium)

See ./configure --help for the full list of options.

make -j `nproc`

{{< edit-button to="/content/post/build-code.md" name="Edit page">}}

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

build-code.md

build-code.md

Build CODE

Gitpod {#build-code-on-gitpod}

openSUSE {#build-code-on-opensuse}

Dependencies

LibreOffice

Building CODE

Fedora {#build-code-on-fedora}

Dependencies

LibreOffice

Building CODE

Arch {#build-code-on-arch}

Dependencies

LibreOffice

Building CODE

Debian {#build-code-on-debian}

Dependencies

LibreOffice

Building CODE

Ubuntu {#build-code-on-ubuntu}

Dependencies

LibreOffice

Building CODE

Build CODE & LO {#build-code-n-lo}

Dependencies

LibreOffice

Option A - Build LibreOffice locally (Recommended)

Option B - Download a Daily-Built Archive of LibreOffice (Quick & Dirty)

Building CODE

Files

build-code.md

Latest commit

History

build-code.md

File metadata and controls

Build CODE

Gitpod {#build-code-on-gitpod}

openSUSE {#build-code-on-opensuse}

Dependencies

LibreOffice

Building CODE

Fedora {#build-code-on-fedora}

Dependencies

LibreOffice

Building CODE

Arch {#build-code-on-arch}

Dependencies

LibreOffice

Building CODE

Debian {#build-code-on-debian}

Dependencies

LibreOffice

Building CODE

Ubuntu {#build-code-on-ubuntu}

Dependencies

LibreOffice

Building CODE

Build CODE & LO {#build-code-n-lo}

Dependencies

LibreOffice

Option A - Build LibreOffice locally (Recommended)

Option B - Download a Daily-Built Archive of LibreOffice (Quick & Dirty)

Building CODE