Reshaping Apache Isis for version 2.0.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.




This app demonstrates some of the features available in Apache Isis v2.

The app is built against the latest milestone builds of Apache Isis v2, and is published as a Docker image on Docker hub.


Install Docker on your computer.

Running the Docker Image

Run the demo image using:

docker run --name demo -p8080:8080 apacheisis/isis-2-demo

This will pull down the latest image from Docker hub and then start a new Docker container named 'demo'.

The demo-app can then be accessed at http://localhost:8080/wicket/. Login with sven:pass.

To stop and remove the container named 'demo' use:

docker stop demo && docker rm demo


To run the Demo App in prototyping mode, add an environment variable PROTOTYPING=true. The first command above then becomes:

docker run --name demo --detach -p8080:8080 -ePROTOTYPING=true apacheisis/isis-2-demo

To run the container with your console attached, replace the '--detach' argument with '-it'. (Use CTRL-C to stop and detach.)

docker run --name demo -it -p8080:8080 apacheisis/isis-2-demo

How we build the image

This repo is mirrored to gitlab, where a CI pipeline builds the image and pushes to Docker hub.

Building a new image of the app in this repo just requires configuring a gitlab remote and pushing to that remote. We just add the following to .git/config:

[remote "gitlab"]
    url =
    fetch = +refs/heads/*:refs/remotes/gitlab/*


We are in the process of reshaping Apache Isis for a version 2.0. The process is open to the community. With this repository we’d like to inspire discussion on design drafts.


If you like to get involved, please feel free to open new issues here or just join the discussion and provide feedback.

If you are interested in contributing to Apache Isis, see the Developers' Guide for details.


This Demo App uses icons made by Freepik and Smashicons from which are licensed by CC 3.0 BY. We use flexmark for markdown rendering.