Quick Start Using Docker

The general procedure is:

1. Install Docker on your machine – see Installing Docker

2. On Windows and Mac only, install Unison (a file synchronization tool) – see Installing Unison. Installing Unison is not essential if you only intend to run the demo, but you should install it if you intend to do any development work (see What is Unison for? below).

3. Download the DPRES demo publication and unpack it – see Getting the DPRES Demo

4. Install the DPRES components in Docker containers – see Installing the DPRES Components

5. Run the Docker containers – see Starting DPRES

What is Unison for?

When you make a change to a Twig template or a SCSS style sheet, the Linux kernel in which your containers are running is not aware of the changes, and is therefore unable to notify the affected processes. This means that handy update mechanisms such as automatic recompilation of CSS files, regeneration of the style guide and browser syncing do not work properly. Without Unison, you would need to restart the Waiter container everytime you made a change in order to see the results in the browser. Unison solves this problem by copying all changes in the templates folder from your local machine into the Linux virtrual machine's file system. The Linux kernel can then notify the correct processes about the changes, ensuring that all the update mechanisms work as expected and you see the results of the changes in your browser.