anchor.diff: -image:https://gitlab.com/apache-isis-committers/isis-2-demo/badges/v2/build.svg[]
  +image:https://github.com/apache-isis-committers/isis-nightly/workflows/Nightly/badge.svg[link="https://github.com/apache-isis-committers/isis-nightly/actions?query=workflow%3A%22Nightly%22"]
   
   = Demo App
   
  
positive.code: The app is built against the latest https://github.com/apache/isis/tree/v2[snapshot] builds of Apache Isis v2 and is published as a Docker image on https://hub.docker.com/repository/docker/apacheisis/isis-2-demo[Docker hub].
  
  
  == Prereqs
  
  Install https://www.docker.com/community-edition[Docker] on your computer.
  
  == Pulling the Docker Image
  
  Pull the demo image using:
  
  [source]
  ----
  docker pull apacheisis/isis-2-demo
  ----
  
  This will pull down the latest demo image from https://hub.docker.com/r/apacheisis/isis-2-demo/tags/[Docker hub]
  
  == Running the Docker Image
  
  Run the demo image using:
  
  [source]
  ----
  docker run --name demo --detach -p8080:8080 apacheisis/isis-2-demo
  ----
  
  This will start a new Docker container named 'demo'.
  
  The demo-app can then be accessed at 
  
  . http://localhost:8080/wicket/[] (tomcat) 
  . http://localhost:8080/isis-2-demo/wicket/[] (payara, using a context-path)
  
  Login with `sven:pass`.
  
  To stop and remove the container named 'demo' use:
  
negative.code: docker stop demo && docker rm demo
  ----
  
  === Customization
  
  To run the _Demo App_ in _prototyping_ mode, add an environment variable `PROTOTYPING=true`.
  The 'run' command above then becomes:
  
  [source]
  ----
  docker run --name demo --detach -p8080:8080 -ePROTOTYPING=true apacheisis/isis-2-demo:<tag>
  ----
  
  To run the container with your console attached, replace the '--detach' argument with '-it'. (Use CTRL-C to stop and detach.)
  
  [source]
  ----
  docker run --name demo -it -p8080:8080 apacheisis/isis-2-demo:<tag>
  ----
  
  == Contributing
  
  