---
source: https://carbone.io/documentation/developer/on-premise-installation/install-on-macos.html
title: "Deploy on MacOS"
description: "Learn how to install on MacOS manually"
generated_at: "2026-07-24"
---

# Deploy on MacOS

Learn how to install on MacOS manually

> ℹ️ **Note:** By default, the program runs with free Community features. To use Carbone Enterprise Edition, you need a Carbone license. [Contact us](https://carboneio.pipedrive.com/scheduler/5Rzzbxu6/carbone-on-premiseaws-presentation) to learn more, or request a free 30-day trial in our chat.

You can use Carbone with Docker on your macOS machine. To get started, see [Deploy with Docker](/documentation/developer/self-hosted-deployment/deploy-with-docker.md).

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](https://carbone.io/changelog.md).
    
2.  In your terminal, run `chmod +x carbone-ee` to make the binary executable.
    
3.  Authorize the binary execution:
    
    ```bash
    xattr -dr com.apple.quarantine carbone-ee
    ```
    
4.  Install LibreOffice [See instructions](#install-libreoffice).
    
5.  Start the Carbone web server. You can pass [options](/documentation/developer/on-premise-installation/configuration.md) to Carbone On-Premise through the CLI:
    
    ```bash
    # 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](http://localhost:4000) to use the studio, or call [the API](https://carbone.io/documentation/developer/http-api/introduction.md) directly.
    

## Install LibreOffice

> ⚠️ **Warning:** On macOS only, use an older version of LibreOffice (up to 25.2.4.1).  
> You can download it from [this link](https://downloadarchive.documentfoundation.org/libreoffice/old/). The LibreOffice team decided in this [commit](https://gerrit.libreoffice.org/c/core/+/185792) to block any process that starts an embedded Python instance from an external process (like Carbone).  
> An [issue](https://bugs.documentfoundation.org/show_bug.cgi?id=167752) was created, and we are working to find a solution.

To install LibreOffice, follow the [official documentation](https://www.libreoffice.org/download/download-libreoffice/).

## Related topics

- [Upgrade Guide](/documentation/developer/on-premise-installation/upgrade-guide.md)
- [Template management](/documentation/developer/on-premise-installation/template-management.md)
- [On-Premise Requirements](/documentation/developer/on-premise-installation/requirements.md)
- [On-Premise plugins](/documentation/developer/on-premise-installation/plugins.md)
- [Metrics (OpenMetrics)](/documentation/developer/on-premise-installation/metrics.md)
- [On-Premise](/documentation/developer/on-premise-installation/introduction.md)