Public | Automated Build

Last pushed: 10 months ago
Short Description
A Docker image for the RAML API Console (
Full Description

NDD Docker RAML API Console

A Docker image for the RAML API Console.


From source

git clone
cd ndd-docker-raml-api-console
docker build -t ddidier/raml-api-console .

From Docker Hub

docker pull ddidier/raml-api-console


The API directory on the host <HOST_DATA_DIR> must be mounted as a volume under /data in the container.

Use -v <HOST_DATA_DIR>:/data to use a specific documentation directory or -v $(pwd):/data to use the current directory as the API directory.

Then you must create an HTML file in <HOST_DATA_DIR> referencing the parser and your RAML file, for example <HOST_DATA_DIR>/some-api.html:

<!doctype html>

<html lang="en">

  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>API Console</title>
  <link href="../styles/api-console-light-theme.css" rel="stylesheet" class="theme">

<body ng-app="ramlConsoleApp" ng-cloak>
  <script src="../scripts/api-console-vendor.js"></script>
  <script src="../scripts/api-console.js"></script>
  <raml-console-loader src="some-api.raml"
    options="{ disableThemeSwitcher: true, resourcesCollapsed: false}">


Note that:

  • the RAML file must be in the mounted directory or below
  • the available options must be passed as JSON

Then run a container:

docker run -it --rm -p 9000:9000 -p 35729:35729 -v <HOST_DATA_DIR>:/data --name api-console ddidier/raml-api-console

And open your browser at http://localhost:9000/apis/some-api.html

Docker Pull Command