Scenarioo Viewer Docker Image
Scenarioo provides a Docker Image to run the Scenarioo Viewer web application on your local machine, on a server or somewhere in the cloud.
The following page describes, how to install and run this docker image (it is more or less a one liner! :smile: ).
To run the Scenarioo docker image it is necessary to install Docker. Visit the docker installation page for installation guides.
Run Scenarioo Docker Image
How to set up and run the Scenarioo Viewer Web App as a docker image:
- Simply run the following one liner command to install and run the docker image:
with following parameters:
sudo docker run -it --name scenarioo -p 8080:8080 -v /home/user/your-scenarioo-docu-folder:/scenarioo/data scenarioo/webapp:5.0.2
--name- defines a name for the container (= running image)
-p- maps a port of your host OS to the container's internal port.
-v- maps the directory where your Scenarioo documentation data and config will be stored, simply replace
/home/user/your-scenarioo-docu-folderby the absolute path to the folder where you want Scenarioo to read from and store in the documentation and config data. Make sure that the docker image wil have read and write access to this directory for storing its data (on linux use simply
sudo chmod ug+rws <scenarioo-docu-directory>or see Viewer Web App Setup for more information in case of problems).
- Remark for Backwards-Compatibility when migrating an existing docker setup (version 3.x or before) to the newest docker image version: the new docker image will as well store its config file inside the configured data directory, this was not the case for earlier docker image versions out of the box. Therefore you might have to migrate your settings from config files inside your old docker containers to the new container, if you had any special settings configured before. In future this wont be an issue anymore, since the config file is now as well stored in your configured Scenarioo data directory.
Access http://localhost:8080/scenarioo/ in your web browser to verify the Viewer application is running.
At this point, the Scenarioo Configuration is only in memory. Go to
General Settings(see upper right navigation in the Viewer) and at least add your application name and save the configuration. The configuration file
config.xmlwill be saved to the directory you have configured as docu directory.
Start adding your documentation data to the mapped directory and let the Viewer application import it. More information on how to publish documentation data can be found in How to Publish Documentation Data
You can configure advanced settings of the Scenarioo Viewer as explained in Viewer Configuration by changing the stored
config.xmlinside the mapped directory.
DockerHub for the official Scenarioo docker image that we provide.
Docker for more information and documentation about docker.
Viewer Web App Setup Instructions, to refer to in case of troubles with the web app setup inside the docker image.
Viewer Configuration for more advanced configuration options.
Publish Documentation Data for how to publish documentation data to the Scenarioo Viewer Web App.