---
title: "Run Sepasoft Demo with Docker"
id: "run-sepasoft-demo-with-docker"
project: "Knowledge Base"
url: "https://docs.sepasoft.com/articles/knowledge-base/run-sepasoft-demo-with-docker"
updated: 2026-07-23T18:08:44Z
---

# Run Sepasoft Demo with Docker

## Setting Up Docker

* [Initial set up](/articles/knowledge-base/run-sepasoft-demo-with-docker/a/h1__889389975)
* [Uninstall Docker Toolbox if you have it](/articles/knowledge-base/run-sepasoft-demo-with-docker/a/h2__1952538450)
* [Installing Docker Desktop](/articles/knowledge-base/run-sepasoft-demo-with-docker/a/h2_2114811887)
* [Installing/Running Sepasoft Demo](/articles/knowledge-base/run-sepasoft-demo-with-docker/a/h2_632172367)
* [Stopping Sepasoft Demo](/articles/knowledge-base/run-sepasoft-demo-with-docker/a/h2__1826553328)
* [Removing Sepasoft Demo](/articles/knowledge-base/run-sepasoft-demo-with-docker/a/h2__1181290331)

* * *

### Initial set up

Follow these instructions to instantiate a containerized instance of the MES Platform 3 demo server. The demo uses Ignition 8.1.22 with 3.81.7 RC1 MES modules, along with a Postgres 14 database.

**Prerequisites:** Windows 10 or 11

### Uninstall Docker Toolbox if you have it

* If you have installed Docker Toolbox, an older version of Docker on Windows, then uninstall it.

### Installing Docker Desktop

* Download [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)
* Install Docker Desktop with the default options.
* Restart windows when prompted by Docker Desktop installer.
* You may be prompted to download WSL 2 Linux kernel updates and install them. If so, follow the links in the prompt then download and install the additional software.
* Restart your computer if prompted to do so
* After restarting, Docker should start up automatically. Docker shows as an icon in the system tray (the area with small icons in the bottom right of the the windows task bar). See icon below:
![](/resources/Storage/knowledge-base/run-sepasoft-demo-with-docker/Docker%20tray%20icon.png)
* Wait until Docker has completed starting. The system tray icon will be moving if it is in the process of starting up.

#### Installing/Running Sepasoft Demo

* Download [sepasoft_demo.zip](/resources/Storage/knowledge-base/sepasoft_demo.zip)
* Extract the contents of the zip file. This can be done by right clicking on the file, selecting "Extract All" from the context menu, selecting where to extract the contents, then clicking the "Extract" button.
* In the extracted contents, there should be folder named `sepasoft_demo`. Under it there will be these files:
`docker-compose.ymlconfigure_port.bat` `run.bat`
`remove_containers_and_data.batstop.bat`
* The Ignition port for the Sepasoft Demo defaults to 9088. If you wish to change the default port then double-click `configure_port.bat` to run it and then enter the desired port number and hit enter. Otherwise go to the next step.
* Double click `run.bat` to run Ignition and it's corresponding database. Docker must already be running or you'll get an error. If Docker is not running then start Docker and try running the file again. If Windows Smart Screen blocks you from running the file, click "More Info", and then "Run anyway". The first time run.bat runs Docker will download nearly 2GB of data so it may take several minutes. This 2GB is Ignition, the database, and any data associated with the demo project.
* When the process is complete you should see a message "Successfully started the sepasoft demo server. Open http://127.0.0.1:9088 in a web browser to use it".
* It will still take a minute for everything to finish starting up.
* Open http://127.0.0.1:9088 in a web browser to see the Ignition home screen. You can navigate to the Demo application by scrolling down to "Perspective Session Launcher" and clicking "View Projects". On the next screen click the "Launch Project" button.
* You can log in with one of two users:
    * admin
        * Password is `password`
        * The password should be changed if the demo server will be accessible by anyone else.
        * Grants access to designer and the Ignition configuration pages settings.
        * Also grants access to the perspective application with full application privileges
    * demo
        * Password is `password`
        * Grants access to perspective application with limited application privileges

### Stopping Sepasoft Demo

The demo server will remain running unless you either stop it with the stop.bat script, or stop Docker. To stop it with the script:

* Find the `stop.bat` file that was extracted in the "Installing Sepasoft Demo" steps.
* Double-click the file to run it. If Windows Smart Screen blocks you from running the file, click "More Info", and then "Run anyway".
* If successful you'll see a message "Successfully stopped the Sepasoft demo server. You may close this window.

### Removing Sepasoft Demo

Performing these steps will remove the demo server and all data associated with it:

* Find the `remove_containers_and_data.bat` file that was extracted in the "Installing Sepasoft Demo" steps.
* Double-click the file to run it. If Windows Smart Screen blocks you from running the file, click "More Info", and then "Run anyway".
* If successful you'll see a message "Successfully removed the Sepasoft Demo server. You may close this window."