# Installation Guide > Install DS Server with the official Docker image, a Linux or Windows image of your own, or by hand with systemd, a Windows service or IIS, and license it. - **Product:** DS Server - **Section:** Documentation - **Kind:** Topic - **Path:** DS Server > Installation Guide - **1089 words** - **Web URL:** https://docs.textcontrol.com/ds-server/installation/ - **LLMs URL:** https://docs.textcontrol.com/ds-server/installation/llms.txt - **LLMs-Full URL:** https://docs.textcontrol.com/ds-server/installation/llms-full.txt --- DS Server runs on your own infrastructure: on a Linux or Windows server, in a Docker container or in IIS. The Installation Guide takes administrators and developers from the download to a running server with a signed-in admin portal, and covers what comes after, from ports, logs and HTTPS to several servers behind a load balancer and upgrades to new versions. The current release is DS Server 5.0.2, built with .NET 10. Its download archive *DS Server 5.0.2.zip* holds two builds of the same server: Core in the folder *core*, for Linux and Windows, and Classic in the folder *classic*, for Windows only. To evaluate DS Server without installing anything, use a [Trial Token](https://docs.textcontrol.com/ds-server/getting-started/trial-token/llms-full.txt) instead. ### Choose an Installation | Installation | Build | Choose it when | |---|---|---| | [Official Docker image](https://docs.textcontrol.com/ds-server/installation/docker-hub/llms-full.txt) | Core | You want a running server with one command, for example to evaluate DS Server | | [Your own Linux image](https://docs.textcontrol.com/ds-server/installation/docker-linux/llms-full.txt) | Core | You need a release or configuration the official image doesn't have | | [Your own Windows image](https://docs.textcontrol.com/ds-server/installation/docker-windows/llms-full.txt) | Classic | You need Windows containers and the formats or rendering of the Classic build | | [Manual installation](https://docs.textcontrol.com/ds-server/installation/manual/llms-full.txt) on Linux | Core | You run DS Server with `dotnet`, usually as a systemd service | | [Manual installation](https://docs.textcontrol.com/ds-server/installation/manual/llms-full.txt) on Windows | Core or Classic | You run DS Server with `dotnet`, as a Windows service or in IIS | [Core and Classic](https://docs.textcontrol.com/ds-server/overview/core-classic/llms-full.txt) explains the differences between the builds, including the document formats that Core supports on Linux. ### Where to Start 1. **Check the requirements** of your build: the operating system, the .NET runtimes and, on Windows, the Visual C++ Redistributable and, if IIS hosts DS Server, the IIS features. See [Requirements](https://docs.textcontrol.com/ds-server/installation/requirements/llms-full.txt). 2. **Install DS Server** in one of the ways above. 3. **Sign in to the admin portal** with the user name `admin` and the password `admin`, and change the password. See [Default Admin Password](https://docs.textcontrol.com/ds-server/administration/admin-password/llms-full.txt). 4. **Register the server** with your serial number. See [Licensing](https://docs.textcontrol.com/ds-server/administration/licensing/llms-full.txt). 5. **Create a security profile** for your application and connect it. See [Creating Security Profiles](https://docs.textcontrol.com/ds-server/administration/security-profiles/llms-full.txt) and [Getting Started](https://docs.textcontrol.com/ds-server/getting-started/llms-full.txt). ### Find the Right Page | If you want to | Read | |---|---| | Check the runtimes and Windows components each build needs | [Requirements](https://docs.textcontrol.com/ds-server/installation/requirements/llms-full.txt) | | Run the official image and keep its admin database on a volume | [Installing with Official Image from Docker Hub](https://docs.textcontrol.com/ds-server/installation/docker-hub/llms-full.txt) | | Build a Linux or Windows container image from the archive | [Installing using Docker (Core on Linux)](https://docs.textcontrol.com/ds-server/installation/docker-linux/llms-full.txt), [Installing using Docker (Classic on Windows)](https://docs.textcontrol.com/ds-server/installation/docker-windows/llms-full.txt) | | Run DS Server as a systemd service, a Windows service or an IIS site | [Manual Installation](https://docs.textcontrol.com/ds-server/installation/manual/llms-full.txt) | | Share security profiles between servers and set up sticky sessions | [Multiple Servers with Load Balancing](https://docs.textcontrol.com/ds-server/installation/load-balancing/llms-full.txt) | | Change ports, logs, the admin database path or other settings | [Configuration](https://docs.textcontrol.com/ds-server/installation/configuration/llms-full.txt) | | Serve DS Server over HTTPS with a certificate | [HTTPS](https://docs.textcontrol.com/ds-server/installation/https/llms-full.txt) | | Move an installation to a new release | [Upgrading](https://docs.textcontrol.com/ds-server/installation/upgrading/llms-full.txt) | ### Pages in This Section - [Requirements](https://docs.textcontrol.com/ds-server/installation/requirements/llms-full.txt): operating systems, .NET runtimes, Windows components and ports. - [Installing with Official Image from Docker Hub](https://docs.textcontrol.com/ds-server/installation/docker-hub/llms-full.txt): tags, the first start, licensing and a volume for the admin database. - [Installing using Docker (Core on Linux)](https://docs.textcontrol.com/ds-server/installation/docker-linux/llms-full.txt): a Dockerfile for the Core build on the ASP.NET Core 10.0 image. - [Installing using Docker (Classic on Windows)](https://docs.textcontrol.com/ds-server/installation/docker-windows/llms-full.txt): a Dockerfile for the Classic build on Windows Server Core. - [Manual Installation](https://docs.textcontrol.com/ds-server/installation/manual/llms-full.txt): Linux with systemd, Windows with a Windows service or IIS, and the first sign-in. - [Multiple Servers with Load Balancing](https://docs.textcontrol.com/ds-server/installation/load-balancing/llms-full.txt): cloned security profiles, authentication servers and sticky sessions. - [Configuration](https://docs.textcontrol.com/ds-server/installation/configuration/llms-full.txt): *hostsettings.json*, *appsettings.json*, environment variables, logs, *Admin.db* and the folders of the installation. - [HTTPS](https://docs.textcontrol.com/ds-server/installation/https/llms-full.txt): Kestrel endpoints with a certificate, in files, environment variables and containers. - [Upgrading](https://docs.textcontrol.com/ds-server/installation/upgrading/llms-full.txt): what to keep and the steps for servers, containers and each major version. --- ## In This Section - [Configuration](https://docs.textcontrol.com/ds-server/installation/configuration/llms-full.txt): Configure DS Server with hostsettings.json, appsettings.json, environment variables and web.config: ports, log files, the Admin.db database, plugins and fonts. - [Installing With Official Image From Docker Hub](https://docs.textcontrol.com/ds-server/installation/docker-hub/llms-full.txt): Run the txtextcontrol/dsserver-core image from Docker Hub: tags, docker run on port 5000, admin sign-in, licensing and a volume that keeps Admin.db and logs. - [Installing Using Docker (Core on Linux)](https://docs.textcontrol.com/ds-server/installation/docker-linux/llms-full.txt): Build your own Linux container image from the core folder: a Dockerfile on the ASP.NET Core runtime image, HTTP on port 5000, a data volume, plugins, settings. - [Installing Using Docker (Classic on Windows)](https://docs.textcontrol.com/ds-server/installation/docker-windows/llms-full.txt): Build a Windows container image of the Classic build: a Dockerfile on Windows Server Core that installs the Visual C++ and .NET runtimes and starts Kestrel. - [HTTPS](https://docs.textcontrol.com/ds-server/installation/https/llms-full.txt): Serve DS Server over HTTPS: set Kestrel endpoints with a PFX or PEM certificate in appsettings.json or environment variables, in Docker, or bind it in IIS. - [Multiple Servers With Load Balancing](https://docs.textcontrol.com/ds-server/installation/load-balancing/llms-full.txt): Run several instances behind a load balancer: license each, clone security profiles with the admin endpoints or use authentication servers, set sticky sessions. - [Manual Installation](https://docs.textcontrol.com/ds-server/installation/manual/llms-full.txt): Install DS Server from the archive without Docker: run it with dotnet on Linux as a systemd service, on Windows as a Windows service or in IIS, then sign in. - [Requirements](https://docs.textcontrol.com/ds-server/installation/requirements/llms-full.txt): Check what Core and Classic need: Linux or Windows Server, the ASP.NET Core and .NET Desktop runtimes, the Visual C++ Redistributable, IIS WebSockets and ports. - [Upgrading](https://docs.textcontrol.com/ds-server/installation/upgrading/llms-full.txt): Upgrade DS Server to a new release: keep Admin.db, settings, certificates and plugins, replace the folder or container, and follow the steps for 3.0 to 5.0. --- ## Nearby - **Previous:** [Licensing Overview](https://docs.textcontrol.com/ds-server/overview/licensing/llms-full.txt) - **Next:** [Requirements](https://docs.textcontrol.com/ds-server/installation/requirements/llms-full.txt)