Showing results for 
Search instead for 
Did you mean: 
Showing results for 
Search instead for 
Did you mean: 

Ask the Expert: What should I know about running ThingWorx in Docker containers?


Ask the Expert: What should I know about running ThingWorx in Docker containers?

Exciting news! ThingWorx now has improved support for Docker containers to help you manage CI/CD, improve development efficiency in your organization and save costs. Check out these FAQs below and, as always, reach out to me if you have any additional questions.


Stay connected,



FAQs: ThingWorx Docker Containers


What are Docker Containers?

From “a Docker container image is a lightweight, standalone, executable package of software that includes everything needed to run an application: code, runtime, system tools, system libraries and settings”. Learn more here.


What's the difference between Docker containers and VMs?

Containers are an abstraction at the app layer that packages code and dependencies together, whereas Virtual Machines (VMs) are an abstraction of physical hardware turning one server into many servers. Here are some great discussions on it on Stack Overflow.Containers&VMs.pngContainers vs. VMs


How can I build ThingWorx Docker images?

Check out the Building ThingWorx 8.3 Docker Images Guide or watch this video to instruct you on how to build and test Docker containers.

(view in My Videos)


How does PTC support building ThingWorx Docker images?

PTC provides the ability for customers and partners to build ThingWorx Docker images. A customer can download the Dockerfiles and scripts packaged as a zip folder from the PTC Software Downloads Portal under ThingWorx Platform,then Release 8.3”  thenThingWorx Dockerfiles.” (Please note that you must be logged in for the link to function properly.)

image-20180927-155940.pngPTC Software Downloads PortalThe zip folder contains the Dockerfiles, template jar, and scripts to fetch Tomcat, and ThingWorx WAR files using CLI. Java must be downloaded manually from the vendor's website. We also provide an instructional guide called “Build ThingWorx Docker Images available on the Reference Documents page on the Support Portal.


How are ThingWorx Docker images different from the usual delivery media of WAR files?

The WAR file delivery is typically accompanied by an installation guide that contains the manual steps for creating the VM or bare-metal environment. That guide includes instructions for the administrator to manually install the prerequisites, including Tomcat, Java, and ThingWorx platform settings files. To deploy and run the WAR file, the administrator follows the guide to create the runtime environment on an OS. In contrast, the Dockerfile build in this delivery automates the creation of a Docker image once supplied with the prerequisites.


Do you have any reference deployment and guidance?

Yes, you can refer to our blog post to learn how to deploy and run ThingWorx Docker containers on your existing Kubernetes environment.


Is there any recommendation on which Container Orchestrator as a Service (CaaS) a customer should run ThingWorx Foundation Docker container images on?

You can use Docker-Compose for testing, but it is generally not suggested for production deployment use cases. In a production environment, customers should use container orchestrators such as KubernetesOpenShiftAzure Kubernetes Service (AKS), or Amazon Elastic Container Service for Kubernetes (Amazon EKS), to deploy and manage ThingWorx Docker images.


What are the skill sets required?

Familiarity with OS CLI and Docker tools is required to build building the ThingWorx Docker images. Familiarity with Docker-compose to run the resulting Docker containers is needed to test the resulting builds. We don’t recommend Docker-Compose for production use, but when using it for local testing and demo purposes, users can rapidly install ThingWorx and get it up and running in minutes.

We expect PTC partners and customers who want to run ThingWorx containerized instances in their production environment to possess the required skill sets within their DevOps team.


How is ThingWorx licensing handled with the Docker images?

By default, the container created from these Docker images starts up in a limited mode with no license supplied. You can configure your username and password for the PTC licensing portal to automatically load a license via environment variables passed into the container on startup. Additionally, you can mount a volume to the /ThingworxPlatform directory, which contains your license file, or to retrieve a license request. To keep your Host ID consistent, ensure that the /ThingworxStorage and /ThingworxPlatform directories are persisted and not removed with individual container restarts.

More detailed instructions can be found in the build guide or in a Kubernetes blog post .


Is Docker free? What version of Docker does PTC support for ThingWorx?

Docker is open-source and licensed under the Apache 2 license. Information on Docker licensing can be found here.

The following Docker versions are required:

  • Docker Community Edition (docker-ce)
    • Version 18.05.0-ce is recommended. To install the Docker Community Edition on your system, follow the instructions for your operating system on the Docker website here.
  • Docker Compose (docker-compose)
    • Version 1.17.1 is recommended. To install the Docker Compose on your system, follow the instructions for your operating system on the Docker website here.

What persistence providers are currently supported?

PTC provides the ability to build ThingWorx Foundation containers for the following supported persistence providers:

  • H2
  • Microsoft SQL Server
  • PostgreSQL

Additional persistence providers will be added to the Docker build delivery as the ThingWorx Foundation Platform releases support for those new databases in future releases.


What are some of the security best practices?

For production use, customers are strongly advised to secure their Docker environments by following all the recommendations provided by Docker. Review and implement the best practices detailed at


Can we build Docker images for ThingWorx High Availability (HA) architecture?

Yes. ThingWorx Dockerfiles are provided for both basic ThingWorx deployment architecture and HA ThingWorx deployment architecture.


How easy is the rehosting and upgrading of ThingWorx releases on Docker with existing data?

In Kubernetes environment, data is kept in a separate volume and can be attached to different containers. When one container dies, the data can be attached to a different container and the container should start without issue. For more information, please refer to the upgrade section of the Building ThingWorx 8.3 Docker Images Guide.


Is it okay to use the Docker exec and access the bash shell to make config changes or should I always rebuild the image and re-deploy?­

Although using Docker exec to gain access to the container internals is useful for testing and troubleshooting issues, any changes made will not be saved after a container is stopped. To configure a container's environment, variables are passed in during the start process. This can be done with Docker start commands, using compose files with environment variables defined, or with helm charts.

More detailed instructions can be found in the build guide or in this blog post .


What if there are issues? Should I call PTC Technical Support?

We are providing the scripts and reference documents solely to empower our community to build ThingWorx Docker images. We believe that customers using Docker in their production processes would have expertise to manage running Docker containers themselves. If there are any issues or questions regarding the build scripts provided in the PTC official downloads portal, then customers can contact PTC Technical Support at 1-800-477-6435 or visit us online at: PTC does not provide support for orchestration troubleshooting.


What can you share about future roadmap plans?
As we are enabling our customers and partners to build ThingWorx Foundation Platform Docker images, we plan to do the same for upcoming products such as ThingWorx Integration & Orchestration, ThingWorx Analytics, upcoming persistence providers such as InfluxDB, and many more.

We also plan to provide additional reference architecture examples and use cases to help developers understand how to use Docker containers in their DevOps and production environments.


Where can I learn more about Docker containers and container orchestrators?

See these resources below for additional information: