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

  1. Download the Carbone On-premise binary for macOS from our changelog page.

  2. In your terminal, run chmod +x carbone-ee to make the binary executable.

  3. Authorize the binary execution:

    xattr -dr com.apple.quarantine carbone-ee
  4. Install LibreOffice See instructions.

  5. 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 4000
  6. Open 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:

  1. $HOME/libreoffice-python/Resources/python
  2. /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: