Installing ElmapiCMS on macOS

Installing ElmapiCMS on macOS

This guide walks you through setting up ElmapiCMS 4.0 on macOS 12+ (Monterey and newer) from the private repository.

We recommend Laravel Herd for macOS.

Bought on CodeCanyon?

Extract elmapicms.zip first — see For CodeCanyon buyers — then skip Clone the repository below and continue from Install PHP dependencies.

Laravel Herd

Download the macOS installer from the Herd website.

Open the DMG, install Herd, and complete onboarding. Herd parks projects at ~/Herd and serves them on .test.

Clone the repository

cd ~/Herd
git clone [email protected]:elmapicms/elmapicms.git elmapicms
cd elmapicms

Install PHP dependencies

composer install

Troubleshooting

If composer install fails, download vendor.zip from Releases and copy it into elmapicms, extract it, and try again.

Copy environment and generate key

cp .env.example .env
php artisan key:generate

Run database migrations and seed the database

php artisan migrate --seed

When prompted for a new SQLite database, type y and press Enter.

Troubleshooting

If migrations fail, download elmapicms.sql from Releases and import it with your database tool.

Build the frontend

npm install && npm run build

Visit the site

herd open

Login

Email:

[email protected]

Password:

password

Additional configuration

Database

SQLite is the default. For MySQL/MariaDB, update .env. See Laravel database configuration.

DB_CONNECTION=mysql
DB_DATABASE=elmapicms
DB_USERNAME=root
DB_PASSWORD=

Development

composer run dev

Next step

Search documentation

Find guides and reference pages