How to Install Directus on macOS

Directus is an open-source headless CMS that allows you to manage your content through a web-based admin panel or API. In this tutorial, we will guide you through the installation process for Directus on macOS.

Prerequisites

Before you begin, you should ensure that you have the following tools installed on your macOS system:

  • Homebrew
  • PHP 7.2 or higher
  • Composer
  • MySQL or Postgres

Steps

  1. Open the terminal on your macOS system and run the following command to install Homebrew:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  1. After installing Homebrew, run the following commands to install PHP, Composer, and other dependencies:
brew install php composer openssl
brew install [email protected] # or any latest version of PHP
  1. Next, install the PHP extensions required by Directus:
sudo pecl install mongodb # use latest version available
  1. Once the extensions are installed, you can download Directus via Composer:
composer create-project directus/app myproject
  1. Next, navigate to your Directus project directory and configure your database settings. Copy the .env.example file to .env using the following command:
cp .env.example .env

  1. In the .env file, replace the DB_HOST and DB_DATABASE fields with the details of your MySQL or Postgres database server.

  2. After configuring the .env file, generate the Directus API by running the following command:

php vendor/bin/directus install:database
  1. Finally, start the Directus server using the following command:
php vendor/bin/directus start

Conclusion

In this tutorial, we have shown you how to install Directus on macOS using Homebrew, PHP, and Composer. With Directus installed, you can start managing your content using the admin panel or API. If you encounter any issues during the installation process, consult the Directus documentation or seek help from the Directus community.