README

Requirements

• The necessary database server, web server, and PHP installed that meet modern Drupal requirements
• Composer
• For local development, we encourage using Docker and DDEV (which includes composer)

Install Mukurtu with DDEV

Using DDEV is the easiest way to get up and running with Mukurtu locally.

• Download and install DDEV
• Make a new folder in which to work and initialize a DDEV project inside it. Run the following commands to download and install Mukurtu.

mkdir mukurtu
cd mukurtu
ddev config --project-type=drupal --docroot=web
# Optional but recommended: install pdftotext inside the DDEV container:
echo "RUN sudo apt -qq update; sudo apt install poppler-utils -y;" > .ddev/web-build/Dockerfile.pdftotext
ddev start
ddev composer create-project mukurtu/mukurtu-template:dev-main
ddev drush si --site-name=Mukurtu --account-name=admin --account-pass=admin
ddev launch

• If planning to develop on the Mukurtu CMS installation profile, follow the additional installation steps to connect a Git checkout to the new project.

Installing Mukurtu CMS with Composer

If installing directly on a web host that has a command line interface, you can install Mukurtu via composer.

• First, install composer. If you do not have it already, it can be downloaded into a directory with the following:

wget https://raw.githubusercontent.com/composer/getcomposer.org/main/web/installer -O - -q | php -- --quiet
# Ideally, move composer into an executable path such as /usr/local/bin/composer.
# But for use only within the current directory, just rename it.
mv composer.phar composer

• Install Mukurtu through composer with the following commands:

mkdir mukurtu
cd mukurtu
composer create-project mukurtu/mukurtu-template:dev-main .

• Set your web server to serve the "web" folder (e.g. mukurtu4/web)
• Install Drupal as normal by opening the site in your web browser, the Mukurtu profile distribution will automatically be used.