Page tree
Skip to end of metadata
Go to start of metadata

You need the docker-engine and Kitematic installed on your local machine. For macOS have a look here for docker and a download link for Kitematic will appear in the menu of the docker status icon.


Find docker images

Just start Kitematic and search for magnolia. You'll find a handful of repositories and the ones to look for are all part of just magnolia. So for example magnolia/community-demohttps://hub.docker.com/r/magnolia/community-demo/

By default you will get the latest version but you can select a specific version if you select the tag in the ellipses menu:

latest btw means the latest version from the master branch.


Versions

The version or tag is combined out of the version of magnolia (e.g. the specified version in the webapp project pom) and the build number of the jenkins job this image was created in.


Start magnolia docker container

After you found the right image click on Create to get a magnolia docker container running. After magnolia has finished starting & installing (it should stop producing log entries end with INFO: Server startup in .... ms) you can click on Web Preview. It will open an empty browser but with the correct port and you have to manually add either magnoliaAuthor or magnoliaPublic and everything should work as expected. 


Multiple containers and ports

You can start multiple magnolia containers this way. They will be all available under different ports which are dynamically created by docker. If you click on Web Preview the newly opened browser will already have the correct port so you don't have to care about that "detail". But if you really want to see the details look under Settings->Hostname/Ports


Use light modules

UNTESTED

Click on the Volumes on the right side and Kitematic will map the volumes to a local folder so you can easily access the files or create light module files.



  • No labels

3 Comments

  1. I was going to install this but Im unsure of best approach now.

    Docker pages seem to recommend "Docker for Mac" as opposed to the "Docker Toolbox". https://docs.docker.com/toolbox/toolbox_install_mac/

    And Kitematic is mentioned as legacy: https://docs.docker.com/kitematic/

    Would you still recommend Kitematic, or is there an easy way to find and use the magnolia containers from the command line or a web interface?

    1. The provided link on the top of the page will direct you to Docker for mac.

      As soon as you have installed docker (its just a drag & drop) and started it up, the docker icon will appear in your status bar.

      From there you can select Kitematic:


      This download the Kitematic app and you can install it as well.


      I don't know of any alternative of Kitematic so I would still use it. You can of course use just the command line which works fine as well.

  2. Michael Mühlebach do you think you could provide descriptions for the mgnl/ce-demo image in Docker Hub? It would probably be important for anybody who comes across the images to understand that they are development snapshots, not officially released versions. The user may end up with a Magnolia instance that doesn't even start.

    https://hub.docker.com/r/mgnl/ce-demo/