| layout | pubDate | modDate | title | description | navOrder |
|---|---|---|---|---|---|
src/layouts/Default.astro |
2023-01-01 |
2023-01-01 |
Migrate to Octopus Server Linux Container from Windows Container |
A guide on how to migrate to the Octopus Server Linux Container from the Octopus Server Windows Container |
20 |
import MigrateFromWindowsToLinuxContainer from 'src/shared-content/installation/migrate-from-windows-to-linux-container.include.md';
The Octopus Server Windows Container has been deprecated starting from Octopus 2020.6. We made this decision because the uptake was low, and Microsoft has stopped supporting the OS Versions we were publishing (Windows 1809, 1903, and 1909). Going forward, we will only publish the Octopus Server Linux Container.
:::div{.hint} We will continue to publish Windows Docker images for Tentacle. Once we've updated the Windows images for Tentacle to more modern OS versions, we will deprecate the existing Windows 1809/1903/1909 images. :::
This guide will help you migrate from the Octopus Server Windows Container to the Octopus Server Linux Container. It assumes you are already familiar with running Octopus Deploy in a container and is meant to address the differences you will encounter when switching over.
This guide is designed to address the differences between the Windows and Linux Containers.
- Folder Paths: Windows Containers follow the Windows folder structure with
\slashes, for example,C:\Octopus\Tasklogs. Linux Containers follow a Linux folder structure, including/slashes. - Pre-installed software: Windows Containers include PowerShell and .NET 4.7.2 (or 4.8) but not Bash. Linux Containers typically include PowerShell Core and Bash but not .NET.
- Software support: The Linux Container doesn't support running ScriptCS or F# scripts directly on the server.
- Authentication: The Octopus Server Linux Container doesn't support Active Directory authentication. Some users have had success using Active Directory with the Octopus Server Windows Container, but any workarounds won't work with the Linux Container. If you want to use Active Directory, you must connect to it via the LDAP authentication provider.
:::div{.hint} The LDAP authentication provider was introduced in Octopus Deploy 2021.2. :::
This guide is meant to address the differences you may encounter when switching from the Octopus Server Windows Container to the Octopus Server Linux Container. For a deeper dive in how to run the Octopus Server Linux Container please refer to this documentation.