Development/HeadlessBuild

TDF LibreOffice Document Liberation Project Community Blogs Weblate Nextcloud Redmine Ask LibreOffice Donate

• Wiki Home
• Development
• Design
• QA
• Events
• Documentation
• Website
• Localization
• Accessibility
• Marketing
• Diversity
• Wiki Help

• Overview
• Reporting Bugs
• How to build
• Code Overview
• Git Commands
• Debugging
• EasyHacks
• Release Plan
• FAQ
• Developers
• Extensions
• → Open Issues

WARNING: This is broken in master and 4.4! Unless you plan to fix it don't use it

Without-X build

LibreOffice can be built without linking to X, cairo, GUI toolkits, etc... This might be helpful on servers or embedded environments.

Note that the soffice --headless command line parameter works on Linux platforms by default already and does not require special build time configuration, but the binaries will require X11 libraries in order to run.

Since LibreOffice 4.1 you don't need git to have all the current headless build features.

To build LibreOffice without dependencies on X11 libraries:

./autogen.sh --without-java --without-x --with-theme=no

WARNING: Before LibreOffice 4.4 --without-x option was called --enable-headless

Start LibreOffice, --headless is enabled by default:

/usr/local/lib/libreoffice/program/soffice.bin "--accept=socket,host=localhost,port=2002;urp;"

From LibreOffice 4.1 there's a --pidfile switch that dumps the pid file of soffice.bin to ease monitoring.

A little test with the help of unoconv:

unoconv -f xls foobar.ods