Skip to content

Install Ibexa DXP on macOS or Windows

This page explains how to install Ibexa DXP on macOS or Windows.


This procedure is for development purposes only. Installing Ibexa DXP for production purposes is supported only on Linux.

For information about installing the product on Linux, see Install Ibexa DXP.

Prepare work environment

To install Ibexa DXP, you need a stack with MySQL and PHP. Additionally, you need Node.js and Yarn for asset management. If you want to use a web server, you need to install it as well:

  • For Windows: Apache
  • For macOS: Apache/nginx

The instructions below assume that you are using Apache.


Locate the php.ini file and open it in a text editor. Provide the missing values to relevant parameters, for example, date.timezone and memory_limit:

date.timezone = "Europe/Warsaw"
memory_limit = 4G

Uncomment or add extensions relevant to your project, for example, opcache extension for PHP (recommended, not required):


You can install Apache as a Windows service by running the following command in CMD as administrator:

httpd.exe -k -install

You can then start it with:

httpd.exe -k start

Edit Apache configuration file httpd.conf. Replace placeholder values with corresponding values from your project, for example, ServerName localhost:80. Uncomment relevant modules, for example:

LoadModule rewrite_module modules/
LoadModule vhost_alias_module libexec/apache2/

Get Composer

Install Composer using a package manager, for example, Homebrew.

Download and run Composer-Setup.exe - it will install the latest Composer version.

Install Ibexa DXP

At this point the installation procedure is the same as when installing on Linux. Follow the steps from the main Install Ibexa DXP page.

Set up virtual host

Prepare a virtual host configuration for your site in your Apache directory:

  • For Windows: <Apache>\conf\vhosts
  • For macOS: /private/etc/apache2/users/

Then restart the Apache server.

Set up permissions

Directories var and web/var need to be writable by CLI and web server user. Future files and directories created by these two users will need to inherit those permissions.

For more information, see Setting up or Fixing File Permissions.

Security checklist

See the Security checklist for a list of security-related issues that you should take care of before going live with a project.