Docker Installation

Quick Setup via Auto Install

For a quick setup you may use the auto installation features of Apex to get up and running with an installation including various base packages within a few minutes. To do so, within terminal run the following commands:

composer --no-dev create-project apex/apex apex
cd apex
mv install_example.yml install.yml

sudo docker-compose up -d
sudo docker-compose exec apex apex

That's it, and your new system will be online with various base packages, and you can access your admin panel at

If you receive dependency errors, you may resolve by running:

sudo apt-get update
sudo apt-get install redis libfreetype6-dev php-tokenizer php-mbstring php-zip php-gd php-redis php-gd composer git

Standard Docker Setup

Apex comes with a docker-compose.yml file, making installation via a docker container easy. To start, download Apex with:

composer --no-dev create-project apex/apex apex
cd apex

Open the docker-compose.yml file, and modify starting at line #45 with your desired mySQL login credentials. Next, login to the shell and start the installation wizard with:

sudo docker-compose up -d
sudo docker-compose exec apex bash

Few notes regarding the installation wizard:

  • If not specified below, leave the field to its default by pressing enter.
  • for domain name, enter ""
  • For the redis host, enter "redis"
  • For the mySQL host, enter "mysql".
  • For mySQL database, you can either choose to auto-generate the database / users, or define the credentials you set within the docker-compose.yml file previously.

That's it! Apex should now be installed, and you can view the administration panel at You will most likely want to install some additional packages, such as for example with:

apex install webapp cms maintenance multi_admins users transaction support devkit

You may also list all packages available to you with apex list_packages, and search all packages with apex search TERM.

Need a Professional?

Need development work by the creator of Apex? E-mail matt.dizak@gmail.com for a free consultation.

Recent News

Apex v1.5.4 Released!
Added .env file, Remote Access Client, finalized PostgreSQL, and more...
Apex v1.5 Released!
Auto-Install via YAML, Preloading, CRUD Scaffolding, Code ReOrganization, Import / Export between Packages, and more...
Apex v1.4.0 Released!
New Package Format, Service Providers and Adapters, New Theme Tools, and more

Mailing List

Subscribe to the low traffic mailing list to stay updated on Apex.

Admin Screenshot