# Introducing TXTextControl.Web.Server.Core: A Cross-Platform Backend for TX Text Control Document Editor

> With the release of TX Text Control 33.0, we are excited to introduce TXTextControl.Web.Server.Core, a major upgrade in the way the document editor works on the backend. This article provides an overview of the new architecture and how to deploy the backend on Linux using Docker.

- **Author:** Bjoern Meyer
- **Published:** 2025-03-13
- **Modified:** 2026-07-17
- **Updated:** 2026-02-12
- **Description:** With the release of TX Text Control 33.0, we are excited to introduce TXTextControl.Web.Server.Core, a major upgrade in the way the document editor works on the backend. This article provides an overview of the new architecture and how to deploy the backend on Linux using Docker.
- **5 min read** (931 words)
- **Tags:**
  - ASP.NET Core
  - ASP.NET
  - Document Editor
  - Linux
- **Web URL:** https://www.textcontrol.com/blog/2025/03/13/introducing-txtextcontrol-web-server-core-a-cross-platform-backend-for-tx-text-control-document-editor/
- **LLMs URL:** https://www.textcontrol.com/blog/2025/03/13/introducing-txtextcontrol-web-server-core-a-cross-platform-backend-for-tx-text-control-document-editor/llms.txt
- **LLMs-Full URL:** https://www.textcontrol.com/blog/2025/03/13/introducing-txtextcontrol-web-server-core-a-cross-platform-backend-for-tx-text-control-document-editor/llms-full.txt

---

With the [release of TX Text Control 33.0](https://www.textcontrol.com/blog/2025/03/12/the-wait-is-over-tx-text-control-for-linux-is-officially-here/llms-full.txt), we are pleased to introduce **TXTextControl.Web.Server.Core**, a major upgrade in the way the Document Editor works on the backend. Previously, in TX Text Control 32.0 and earlier, the synchronization service required for the Document Editor was only available as a Windows service. This has now been replaced with a pure .NET 8 application, providing greater flexibility, cross-platform compatibility, and multiple deployment options.

### What is TXTextControl.Web.Server.Core?

TXTextControl.Web.Server.Core is a lightweight .NET 8 application that serves as the backend for the TX Text Control Document Editor. It acts as a web server that enables the synchronization for document editing in the editor. Here are the key benefits:

- **Cross-platform:** Runs on both Windows and Linux.
- **Multiple deployment options:** Can be deployed on Azure App Services, virtual machines, containers (Docker, Kubernetes), or bare-metal servers.
- **Flexible execution:** Can be run as a standalone application, a Windows Service, or a Linux daemon.
- **Lightweight & scalable:** Designed for modern cloud and containerized environments.

### Why the Change?

The transition from a Windows-only service-based architecture to a cross-platform .NET 8 Web application was driven by the need for greater flexibility and modernization. Support for Linux environments has expanded deployment options, particularly for containerized and cloud-based solutions.

The adoption of .NET 8 brings notable improvements in performance, security, and scalability, making it a more robust choice for modern applications. Developers now have the freedom to choose whether to host their document editor backend on-premises or in the cloud, adapting to their specific infrastructure needs. In addition, the move improves the developer experience by removing the complexity of managing Windows services, allowing the application to be deployed and run like any other .NET Web API.

### Deployment Options

One of the main advantages of TXTextControl.Web.Server.Core is its flexibility in deployment. The backend required to host the document editor is a .NET application assembly called *TXTextControl.Web.Server.Core.dll*. This application must be deployed along with additional files required for the web server to function properly.

A very simple way to deploy this web server is described in our Getting Started tutorials, where the required files are added to the project and the TX Text Control files are automatically copied by the NuGet package.

> **Learn More**
> 
> In this article, we will create a simple document editor application using the Document Editor component from the TX Text Control .NET Server product. We will use ASP.NET Core and run the application on Linux using Windows Subsystem for Linux (WSL).
> 
> [Getting Started: Document Editor with ASP.NET Core and Linux WSL Support ](https://www.textcontrol.com/blog/2025/03/12/getting-started-document-editor-with-asp-net-core-and-linux-wsl-support/llms-full.txt)

But in other scenarios, you may want to deploy the backend separately or independently from your consuming application. To run the web server, the following files must be provided:

### TXTextControl.Web.Server.Core Files

These files contain the web server application and are located in the TX Text Control installation folder:

*C:\\Program Files\\Text Control GmbH\\TX Text Control 33.0.NET Server for ASP.NET\\Assembly\\net8.0\\*

- **TXTextControl.Web.Server.Core.dll**: The main assembly that contains the web server.
- **TXTextControl.Web.Server.Core.Process.dll**: The assembly that hosts web server instances.
- **TXTextControl.Web.Server.Core.config.json**: The configuration file for the web server.
- **TXTextControl.Web.Server.Core.deps.json**: The dependency file for the web server.
- **TXTextControl.Web.Server.Core.Process.deps.json**: The dependency file for the web server process.
- **TXTextControl.Web.Server.Core.Process.runtimeconfig.json**: The runtime configuration file for the web server process.
- **TXTextControl.Web.Server.Core.runtimeconfig.json**: The runtime configuration file for the web server.

### TX Text Control Files

The three additional files in the same folder are also required:

- **TXDocumentServer.Core.dll**
- **TXTextControl.Core.dll**
- **TXTextControl.Server.Core.dll**

From the *Assembly* folder, the following files are required:

*C:\\Program Files\\Text Control GmbH\\TX Text Control 33.0.NET Server for ASP.NET\\Assembly\\*

- **TXBarcode.dll**
- **TXDrawing.dll**
- **TXImageProvider.dll**
- **txpdf.dll**
- **TXSVGResources.dll**

### Native Linux or Windows Dependencies

For Linux deployments, all native dependencies are required from the *binunix* folder:

*C:\\Program Files\\Text Control GmbH\\TX Text Control 33.0.NET Server for ASP.NET\\Assembly\\binunix\\*

For Windows deployments, all native dependencies are required from the *bincore64* folder:

*C:\\Program Files\\Text Control GmbH\\TX Text Control 33.0.NET Server for ASP.NET\\Assembly\\bincore64\\*

For Windows, the following files from the *bin64* folder are also required:

- **txdomprs.dll**
- **txsvggen.dll**

### Fonts

In order to use the backend, the fonts must be deployed. Copy the *fonts* folder from the TX Text Control installation folder:

*C:\\Program Files\\Text Control GmbH\\TX Text Control 33.0.NET Server for ASP.NET\\Assembly\\fonts\\*

### Starting the Web Server

Once the required files are deployed, the web server can be started using the following command:

```
dotnet TXTextControl.Web.Server.Core.dll
```

### Configuration

The .NET 8 runtime must be installed on the machine where the web server is running. The web server listens on port 4282 by default. This can be changed in the configuration file *TXTextControl.Web.Server.Core.config.json*.

To set the port, open the configuration file and modify the *TcpPort* property:

```
{
	"Logging": {
		"LogLevel": "Information",
		"FolderPath": "./logs",
		"FileName": "TXTextControl.Web.Server.Core.{date}.log"
	},
	"TcpPort": 5664
}
```

The supported IP versions can also be configured using the *SupportedIPVersions* property. Possible values are *IPv4*, *IPv6*, or *Both*.

```
{
	"Logging": {
		"LogLevel": "Information",
		"FolderPath": "./logs",
		"FileName": "TXTextControl.Web.Server.Core.{date}.log"
	},
	"TcpPort": 5664,
	"SupportedIPVersions": "IPv4"
}
```

---

## About Bjoern Meyer

As CEO, Bjoern is the visionary behind our strategic direction and business development, bridging the gap between our customers and engineering teams. His deep passion for coding and web technologies drives the creation of innovative products. If you're at a tech conference, be sure to stop by our booth - you'll most likely meet Bjoern in person. With an advanced graduate degree (Dipl. Inf.) in Computer Science, specializing in AI, from the University of Bremen, Bjoern brings significant expertise to his role. In his spare time, Bjoern enjoys running, paragliding, mountain biking, and playing the piano.

- [LinkedIn](https://www.linkedin.com/in/bjoernmeyer/)
- [X](https://x.com/txbjoern)
- [GitHub](https://github.com/bjoerntx)

---

## Related Posts

- [Getting Started: Document Editor with ASP.NET Core and Docker Support with Linux Containers](https://www.textcontrol.com/blog/2025/03/12/getting-started-document-editor-with-asp-net-core-and-docker-support-with-linux-containers/llms.txt)
- [Beyond WebSockets: A Glimpse into the Future of Document Editing with WebAssembly](https://www.textcontrol.com/blog/2026/06/10/beyond-websockets-glimpse-future-document-editing-webassembly/llms.txt)
- [5 Layout Patterns for Integrating the TX Text Control Document Editor in ASP.NET Core C#](https://www.textcontrol.com/blog/2026/04/09/5-layout-patterns-for-integrating-the-tx-text-control-document-editor-in-aspnet-core-csharp/llms.txt)
- [Introducing Text Control Agent Skills](https://www.textcontrol.com/blog/2026/03/27/introducing-text-control-agent-skills/llms.txt)
- [Deploying the TX Text Control Document Editor from the Private NuGet Feed to Azure App Services (Linux and Windows)](https://www.textcontrol.com/blog/2026/03/25/deploying-the-tx-text-control-document-editor-from-the-private-nuget-feed-to-azure-app-services-linux-and-windows/llms.txt)
- [Build a Custom Backstage View in ASP.NET Core with TX Text Control](https://www.textcontrol.com/blog/2026/02/17/build-a-custom-backstage-view-in-aspnet-core-with-tx-text-control/llms.txt)
- [ASP.NET Core Document Editor with Backend via the Text Control Private NuGet Feed](https://www.textcontrol.com/blog/2026/02/09/aspnet-core-document-editor-private-nuget-feed/llms.txt)
- [Document Editor with TX Spell .NET on Linux using ASP.NET Core](https://www.textcontrol.com/blog/2026/01/28/document-editor-tx-spell-net-linux-aspnet-core/llms.txt)
- [Why Document Processing Libraries Require a Document Editor](https://www.textcontrol.com/blog/2025/12/04/why-document-processing-libraries-require-a-document-editor/llms.txt)
- [Getting Started Video Tutorial: Document Editor in ASP.NET Core C# on Linux](https://www.textcontrol.com/blog/2025/07/29/getting-started-video-tutorial-document-editor-aspnet-core-csharp-linux/llms.txt)
- [Convert MS Word DOCX to PDF including Text Reflow using .NET C# on Linux](https://www.textcontrol.com/blog/2025/06/10/convert-ms-word-docx-to-pdf-including-text-reflow-using-dotnet-csharp-on-linux/llms.txt)
- [Announcing the Official DS Server Docker Image on Docker Hub](https://www.textcontrol.com/blog/2025/05/02/announcing-the-official-ds-server-docker-image-on-docker-hub/llms.txt)
- [Introducing DS Server 4.0: Linux-Ready and Container-Friendly](https://www.textcontrol.com/blog/2025/04/30/introducing-ds-server-4-linux-ready-and-container-friendly/llms.txt)
- [Creating a .NET Console Application with Visual Studio Code and TX Text Control (on Linux)](https://www.textcontrol.com/blog/2025/04/03/creating-a-dotnet-console-application-with-visual-studio-code-and-tx-text-control-on-linux/llms.txt)
- [TX Text Control Core vs. Classic Performance Comparison Plain Text to DOCX and PDF](https://www.textcontrol.com/blog/2025/03/31/2025-03-31-tx-text-control-core-vs-classic-performance-comparison-plain-text-to-docx-and-pdf/llms.txt)
- [Deploying the TX Text Control Document Editor in an ASP.NET Core Web App to Azure App Services](https://www.textcontrol.com/blog/2025/03/26/deploying-the-tx-text-control-document-editor-in-an-asp-net-core-web-app-to-azure-app-services/llms.txt)
- [Building an ASP.NET Core Backend (Linux and Windows) for the Document Editor and Viewer](https://www.textcontrol.com/blog/2025/03/26/building-an-asp-net-core-backend-for-the-document-editor-and-viewer/llms.txt)
- [TX Text Control for Blazor: Mail Merge Integration Tutorial](https://www.textcontrol.com/blog/2025/03/25/tx-text-control-for-blazor-mail-merge-integration-tutorial/llms.txt)
- [TX Text Control Document Editor and Viewer for Blazor Released](https://www.textcontrol.com/blog/2025/03/25/tx-text-control-document-editor-and-viewer-for-blazor-released/llms.txt)
- [Getting Started: Document Editor for Blazor in ASP.NET Core](https://www.textcontrol.com/blog/2025/03/25/getting-started-document-editor-for-blazor-in-asp-net-core/llms.txt)
- [How to Create PDF Documents with TX Text Control using C# .NET on Linux](https://www.textcontrol.com/blog/2025/03/18/how-to-create-pdf-documents-with-tx-text-control-using-c-sharp-net-on-linux/llms.txt)
- [Benchmarking TX Text Control: Classic vs. Core on Windows and Linux](https://www.textcontrol.com/blog/2025/03/14/benchmarking-tx-text-control-classic-vs-core-on-windows-and-linux/llms.txt)
- [Using TX Text Control with Ultra-Minimal Chiseled Linux Containers](https://www.textcontrol.com/blog/2025/03/12/using-tx-text-control-with-ultra-minimal-chiseled-linux-containers/llms.txt)
- [Getting Started: Document Editor with ASP.NET Core and Linux WSL Support](https://www.textcontrol.com/blog/2025/03/12/getting-started-document-editor-with-asp-net-core-and-linux-wsl-support/llms.txt)
- [Version 33.0 Preview: NuGet Packages Explained and Why we Minimize Dependencies](https://www.textcontrol.com/blog/2025/02/24/version-33-0-preview-nuget-packages-explained-and-why-we-minimize-dependencies/llms.txt)