Installing a Development or Demo Server¶
When developing locally, your Drupal site resides in your
isle-dc/codebase folder and is bind-mounted into your
Drupal container. This lets you update code using the IDE of your choice on your host machine, and the
changes are automatically reflected on the Drupal container.
If you don't already have a Drupal site, you'll be given a basic setup using Drupal 9 and the Islandora Starter Site.
If you do already have a Drupal site, use git to clone it into place as the
Now you'll need to tell
isle-dc to look for it by setting the
ENVIRONMENT variable in
.env file. If you don't have one, copy over
sample.env and name it
You should also change the
COMPOSE_PROJECT_NAME variable. This determines the name of the
Docker containers and volumes that are created when you run
make starter. If you leave this as the default
you will need to be careful not to overwrite the containers with another install of
If your site includes exported configuration from
drush config:export, then you'll also
need to set
Once you are ready, run
to install the Drupal site in your
codebase folder and spin up all the other containers with it.
Enjoy your Islandora instance! Check out the basic usage documentation to see
all the endpoints that are available and how to do things like start and stop Islandora. Your passwords,
including the Drupal admin password, can be found in the
secrets/live directory after you run
To populate your site with some demo content, you can run
make demo_content. This will import some sample objects into your Islandora site.