Docker Image for Linux

Introduction
Framework projects can be deployed to run on Docker containers.

This Document assumes familiarity with Docker.

This document described how to run a project over a Linux Docker Image. It was created using
Linux Ubuntu version 22.04.1 as a host container with Mono Framework 6.12 in it.

Configuration Procedure

Requirements

First of all, you need to have Linux installed and running.

Then, we need to Install Docker Engine for Linux following this Docker Documentation on how
to install it.

Preparing the docker image:

Download from the FactoryStudio Docker files (clicking over the name). Then extract the zip file
“FactoryStudio 9.2.27 - Docker.zip”, inside it you’ll find a Bin folder and a DockerFile:
The Bin folder contains all FactoryStudio files including the project. There is already a sample
project, called “Project”, inside of Bin/Projects.
If you want to put your own project on docker, all you need to do is copy your project file (.tproj)
to the Bin/Projects folder and rename it to “Project.tproj”, replacing the Demo .tproj that came
with the Zip.

Setting the License

The most common, and recommended, way to license a docker is making a Server License in a
Windows computer and setting the docker to search for the license from this Server License. It
is very important to know that a Server License can have as many licenses for as many dockers
as needed.

First of all, edit the RemoteLicenseService.config that is located inside the Bin folder with the
Server IP so FactoryStudio will be able to search for the license in your network.

The syntax is:

RemoteServer=<IpAddress>:<PortNumber>
 //IP:Port where the licensing server is Running “RemoteServer=192.168.1.1:80”

The port should point to the same port as your WebServer (TWebServer or IIS) running on the
Server computer and you can check in the Server tab of FactoryStudio:

The licensing server needs to have a license containing a Remote Licenses

feature.
Setting and running the Docker

To build the image, execute the following commands via terminal, inside the Zip folder, that
should contain the Bin folder and the Docker file, with the alterations you already did, if
necessary:

sudo docker build -t fs .

// Do not forget the "." is IMPORTANT!!!

After successfully built, to run the image, execute the following code in the Terminal:

//specifying the port:

docker run -p 3101:3101 fs

The LocalIP shown in the last line of the image above is the IP of the Docker image (fs), and it
can be used to access the runtime via external clients (Smart and Web) and debugging tools. To
get access from other computers of intranet/internet to this docker image please contact your
system administrator.

Locally (host computer) in Web Browser: http://localhost:3101/HTML5