On-Premise installation
Deploy on MacOS
Learn how to install on MacOS manually
By default, the program runs with free Community features, under the Carbone On-Premise License. The Enterprise Edition requires a license: see Licensing to get a free 30-day trial or a production license.
You can use Carbone with Docker on your macOS machine. To get started, see Deploy with Docker.
This guide explains how to run the application directly on macOS.
Installation
Download the Carbone On-premise binary for macOS from our changelog page.
In your terminal, run
chmod +x carbone-eeto make the binary executable.Authorize the binary execution:
xattr -dr com.apple.quarantine carbone-eeInstall LibreOffice See instructions.
Start the Carbone web server. You can pass options to Carbone On-Premise through the CLI:
# By default, the program runs with free Community features. export CARBONE_LICENSE="xxxxxxx" ./carbone-ee webserver --studio -p 4000Open the browser at http://localhost:4000 to use the studio, or call the API directly.
Install LibreOffice
To install LibreOffice, follow the official documentation.
On macOS, LibreOffice 25.2.4.2 and later no longer allow an external process (like Carbone) to run their embedded Python. See this commit and issues 167645 and 167752.
Carbone looks for an external Python binary on macOS, in this order:
$HOME/libreoffice-python/Resources/python/Applications/libreoffice-python/Resources/python
If none exists, Carbone falls back to the Python bundled with LibreOffice (blocked from 25.2.4.2), then to the system python3. To run LibreOffice on macOS, choose one option:
- Place a Python binary at one of the two paths above.
- Or set both paths explicitly with
libreOfficePath("sofficeExecPath, pythonExecPath"). - Or install LibreOffice 25.2.4.1 or older from the LibreOffice archive.