Installing using Docker (Core on Linux)

The installation using Docker is the recommended method to deploy DS Server on one or more servers.

The following tutorial shows how to create a Dockerfile to create a working image.

1. Create a new folder and name it DSServerDocker.

2. Download the ZIP file from the online store (DS-0400-XB.zip). This file contains all the necessary files for your private DS Server installation. After unzipping the folder, you will find two folders:

   • core - contains the core version of DS Server (platform independent).
   • classic - contains the classic version of DS Server (Windows only).
   
   

   Copy the core folder into the DSServerDocker folder you created.

3. Create a file named Dockerfile (no extension) and place it into the DSServerDocker folder. Your folder structure should look like this:

       DSServerDocker
       Dockerfile
       ├── core
           └── ...
       

   Using any editor, open the Dockerfile and paste the following content into it:

   • docker

   ​# Use the official .NET 8 ASP.NET runtime image
   FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
   
   # Set the working directory inside the container
   WORKDIR /app
   
   # Copy the contents of the core folder
   COPY ./core/ .
   
   # Expose port 80 for the web app
   EXPOSE 80
   
   # Run the application
   ENTRYPOINT ["dotnet", "TXTextControl.DocumentServices.dll"]

   # Use the official .NET 8 ASP.NET runtime image FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base # Set the working directory inside the container WORKDIR /app # Copy the contents of the core folder COPY ./core/ . # Expose port 80 for the web app EXPOSE 80 # Run the application ENTRYPOINT ["dotnet", "TXTextControl.DocumentServices.dll"]

4. To make testing easier, disable HTTPS by opening the file core > hostSettings.json and removing the HTTPS entry from the URLs element. The resulting value should look like this: "urls": "http://*:5000".

5. Assume that you have installed Docker for Windows, open a PowerShell command window with explicit administrator rights and change to the directory where you created the folder docker-test.

6. Type in the following command to build the Docker image based on the Dockerfile in the same directory:

   docker build -t dsserver .

7. Start the container with one of the following commands:

   docker run -it -p 5000:5000 --name mydsserver dsserver

8. In the Docker Dashboard, you can see the running container listening on port 5000. Open a browser and navigate to http://localhost:5000/ to see your deployed web application.