Flight Deck has only been tested on macOS and Linux. It should work on Windows, but this is untested.
Flight Deck is based on Docker. Docker allows you to spin up multiple, lightweight virtual environments on your system called "containers". You can find out more about containers on training.docker.org.
- Download Docker for macOS or Docker for Windows.
- Run the installer and follow on-screen instructions.
- Restart your computer when finished.
Adding Flight Deck to your project¶
When using Flight Deck, it's best to add it permanently to your project repository. That way, anyone working on that project has access to the some stack of containers.
Flight Deck assumes that the docroot/webroot of your PHP project is in a subdirectory of your git repository. This is typically named
public_html. Flight Deck assumes
- Reorganize your repository, if necessary.
- Download a copy of Flight Deck from github. This can be either from a zip, or cloning the repo.
- Copy the
db-backupsdirectory into the root of your project.
- Copy the
.envfile into the root of your project.
- If your project is Drupal 6 or 7, copy
docker-compose.d7-apache.ymlinto the root of your project. For Drupal 8, copy
- Rename the file you copied in the previous step to
Flight Deck keeps it's configuration settings in the
.env file. This includes the database name, user, and password, the varnish secret, if XDebug is enabled, and more.
.env file comes with sensible defaults, but you may wish to change them.
Starting Flight Deck¶
Once the proper files have been deployed and the .env file configured, you're ready to start Flight Deck for the first time.
- Place a MySQL dump in the db-backups directory. This can be in uncompressed SQL, but also in gzip, zip, xs, or lzo format.
- Open a terminal and change to your project root.
- Start Flight Deck with the following command:
docker-compose up -d
- Note that the first build will take longer, as container images need to be downloaded from hub.docker.com. Subsequent restarts will be on the order of seconds.
- Using a web browser, navigate to