Public Repository

Last pushed: 2 years ago
Short Description
Smarkdown application image based on WildFly
Full Description

Smakrdown Docker Image

This is an example Dockerfile for the Smarkown application. This image is based on the latest Wildfly image.


To run with the default configuration

docker run --rm -it -p 8080:8080 scheuchzer/smarkdown

This will provide a simple page at without any other content.

Documents publishing

Default configuration

By default smarkdown will read content from the volume directory /smarkdown_data. You have two possibilities to add content to that folder

  1. Mount a volume
     docker run --rm -it -p 8080:8080 -v /path/to/content:/smarkdown_data scheuchzer/smarkdown
  2. Add your content in your own Dockerfile
     ADD /smarkdown_data/

Custom configuration

You can provide your own configuration. You'll have to do this if

  • you want to connect to locations outside of /smarkdown_data like
    • Classpath
    • Github
  • you want to change the application name
  • you want to change the templates

See the Smarkdown documentation for more infos about the configuration parameters.

Mount your config file like this

docker run --rm -it -p 8080:8080 -v /path/to/config:/etc/smarkdown/cfg.json scheuchzer/smarkdown

Extending the image

By default the following Smarkdown modules get loaded during the building of the image

  • smarkdown-core
  • smarkdown-configuration-filesystem
  • smarkdown-jekyll
  • smarkdown-jsf
  • smarkdown-location-file
  • smarkdown-location-github
  • smarkdown-location-http
  • smarkdown-plantuml
  • smarkdown-yuml

If you don't need all of these or if you need additional modules, ADD a file /opt/smarkdown/modules.cfg to your Dockerfile. This file lists all modules that go into the build, one module per line. See the default file.

After adding the file run the /opt/smarkdown/ script to rebuild the war file. Ther's a environment variable SMARKDOWN_ASSEMBLE_FILE you can use.


If you have very custom stuff to do, ADD a file /opt/smarkdown/ (environment variable SMARKDOWN_THIRDPARTY_FILE). This is a (by default empty) script that gets called by after loading the modules and before packing the war file. In this file you can do whatever you like.


The source is available on GitHub.


Please report any issues on GitHub.

Docker Pull Command