How to Install Pimcore on macOS

Pimcore is an open-source digital platform that helps users to manage their data, documents, and content. In this tutorial, we will guide you through the steps of installing Pimcore on a macOS system.

Prerequisites

• macOS (version 10.13 or higher)
• Apache or Nginx web server
• PHP (version 7.1 or higher)
• MySQL or MariaDB database server
• Composer dependency manager

Installation Steps

Step 1: Install Homebrew

Homebrew is a package manager that simplifies the installation process of various software on macOS.

1. Open the Terminal app.
2. Type in the following command and press Enter:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Wait for the installation process to complete.

Step 2: Install Apache or Nginx

1. Open the Terminal app.
2. Install Apache by typing the following command and press Enter:

brew install httpd

3. Install Nginx by typing the following command and press Enter:

brew install nginx

Step 3: Install PHP

1. Open the Terminal app.
2. Install PHP by typing the following command and press Enter:

brew install php

Step 4: Install MySQL or MariaDB

1. Open the Terminal app.
2. Install MySQL by typing the following command and press Enter:

brew install mysql

3. Install MariaDB by typing the following command and press Enter:

brew install mariadb

Step 5: Install Composer

1. Open the Terminal app.
2. Install Composer by typing the following command and press Enter:

brew install composer

Step 6: Download and extract Pimcore

1. Open the Terminal app.
2. Navigate to the web root directory by typing the following command and press Enter:

cd /Library/WebServer/Documents/

3. Download the Pimcore archive by typing the following command and press Enter:

sudo curl -LO https://github.com/pimcore/pimcore/releases/download/v10.2.1/pimcore-v10.2.1.zip

4. Extract the archive by typing the following command and press Enter:

sudo unzip pimcore-v10.2.1.zip

Step 7: Install Pimcore dependencies

1. Open the Terminal app.
2. Navigate to the extracted Pimcore directory by typing the following command and press Enter:

cd pimcore-v10.2.1

3. Install Pimcore dependencies by typing the following command and press Enter:

composer install

Step 8: Configure Apache or Nginx

For Apache

1. Open the Terminal app.
2. Edit the Apache config file by typing the following command and press Enter:

sudo nano /usr/local/etc/httpd/httpd.conf

3. Find the following line and uncomment it by removing the # symbol:

#LoadModule php7_module lib/httpd/modules/libphp7.so

4. Add the following lines to the end of the file:

<Directory "/Library/WebServer/Documents/pimcore-v10.2.1">
    Options FollowSymLinks Multiviews
    AllowOverride All
    Require all granted
</Directory>

5. Restart Apache by typing the following command and press Enter:

sudo brew services restart httpd

For Nginx

1. Open the Terminal app.
2. Edit the Nginx config file by typing the following command and press Enter:

sudo nano /usr/local/etc/nginx/nginx.conf

3. Find the following line and uncomment it by removing the # symbol:

#include servers/*;

4. Add the following lines to the end of the file:

server {
    listen       80;
    server_name  localhost;
    root         /Library/WebServer/Documents/pimcore-v10.2.1;

    location / {
        index  index.php index.html;
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ .php$ {
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_param  SCRIPT_FILENAME 
        $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}

5. Restart Nginx by typing the following command and press Enter:

sudo brew services restart nginx

Step 9: Create a MySQL or MariaDB database

1. Open the Terminal app.
2. Launch MySQL or MariaDB by typing the following command and press Enter:

brew services start mysql

or

brew services start mariadb

3. Log in to the database by typing the following command and press Enter:

mysql -u root

4. Create a new database by typing the following command and press Enter:

CREATE DATABASE pimcore;

Step 10: Install Pimcore

1. Open a web browser.
2. Navigate to the following URL:

http://localhost/

3. Follow the on-screen instructions to complete the installation process of Pimcore.

Congratulations! You have successfully installed Pimcore on your macOS system.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!