Running a MID Server on Amazon Linux 2023 Using a Containerized Deployment<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } .kb-wrapper * { box-sizing: border-box; } .kb-wrapper h2.section-title { font-size: 14pt; font-weight: 900; color: #032D42; margin-bottom: 14px; padding-bottom: 8px; border-bottom: 2px solid #e8fce4; font-family: Lato, sans-serif; } .kb-wrapper .section { margin-bottom: 34px; } .kb-wrapper .section:last-child { margin-bottom: 0; } .kb-wrapper p { margin-bottom: 12px; color: #0d1f2b; font-family: Lato, sans-serif; font-size: 12pt; line-height: 1.7; } .kb-wrapper ul, .kb-wrapper ol { padding-left: 22px; margin-bottom: 12px; font-family: Lato, sans-serif; font-size: 12pt; line-height: 1.7; } .kb-wrapper li { margin-bottom: 6px; color: #0d1f2b; font-size: 12pt; } .kb-wrapper code { font-family: 'Courier New', Courier, monospace; font-size: 13px; background: #e6f0f5; color: #032D42; padding: 1px 6px; border-radius: 3px; border: 1px solid #b8cfd8; } .kb-wrapper .callout { border-left: 4px solid #52B8FF; background: #e6f4ff; border-radius: 0 6px 6px 0; padding: 13px 16px; margin: 16px 0; font-size: 12pt; font-family: Lato, sans-serif; line-height: 1.7; } .kb-wrapper .callout.warn { border-left-color: #e6a817; background: #fff4e0; } .kb-wrapper .callout strong { display: block; margin-bottom: 4px; font-weight: 700; } .kb-wrapper .steps-list { list-style: none; padding-left: 0; counter-reset: steps; margin-bottom: 12px; } .kb-wrapper .steps-list li { counter-increment: steps; display: flex; gap: 14px; align-items: flex-start; margin-bottom: 14px; } .kb-wrapper .steps-list li::before { content: counter(steps); flex-shrink: 0; width: 26px; height: 26px; background: #032D42; color: #63DF4E; border-radius: 50%; font-size: 12px; font-weight: 900; display: flex; align-items: center; justify-content: center; margin-top: 2px; font-family: Lato, sans-serif; } .kb-wrapper .related-list { list-style: none; padding-left: 0; display: flex; flex-direction: column; gap: 8px; } .kb-wrapper .related-list li { background: #e8fce4; border: 1px solid #a8dfa0; border-radius: 6px; padding: 10px 14px; margin-bottom: 0; } .kb-wrapper .related-list li a { color: #032D42; text-decoration: none; font-size: 12pt; font-weight: 700; font-family: Lato, sans-serif; } .kb-wrapper .related-list li a:hover { text-decoration: underline; color: #0057a8; } .kb-wrapper .link-disclaimer { display: block; font-size: 10pt; font-style: italic; color: #3d5a6a; margin-top: 4px; font-family: Lato, sans-serif; line-height: 1.5; } .kb-wrapper hr.section-divider { border: none; border-top: 1px solid #d0dbe0; margin: 30px 0; } .kb-wrapper * { box-sizing: border-box; } .kb-wrapper h2.section-title { font-size: 14pt; font-weight: 900; color: #032D42; margin-bottom: 14px; padding-bottom: 8px; border-bottom: 2px solid #e8fce4; font-family: Lato, sans-serif; } .kb-wrapper .section { margin-bottom: 34px; } .kb-wrapper .section:last-child { margin-bottom: 0; } .kb-wrapper p { margin-bottom: 12px; color: #0d1f2b; font-family: Lato, sans-serif; font-size: 12pt; line-height: 1.7; } .kb-wrapper ul, .kb-wrapper ol { padding-left: 22px; margin-bottom: 12px; font-family: Lato, sans-serif; font-size: 12pt; line-height: 1.7; } .kb-wrapper li { margin-bottom: 6px; color: #0d1f2b; font-size: 12pt; } .kb-wrapper code { font-family: 'Courier New', Courier, monospace; font-size: 13px; background: #e6f0f5; color: #032D42; padding: 1px 6px; border-radius: 3px; border: 1px solid #b8cfd8; } .kb-wrapper .callout { border-left: 4px solid #52B8FF; background: #e6f4ff; border-radius: 0 6px 6px 0; padding: 13px 16px; margin: 16px 0; font-size: 12pt; font-family: Lato, sans-serif; line-height: 1.7; } .kb-wrapper .callout.warn { border-left-color: #e6a817; background: #fff4e0; } .kb-wrapper .callout strong { display: block; margin-bottom: 4px; font-weight: 700; } .kb-wrapper .steps-list { list-style: none; padding-left: 0; counter-reset: steps; margin-bottom: 12px; } .kb-wrapper .steps-list li { counter-increment: steps; display: flex; gap: 14px; align-items: flex-start; margin-bottom: 14px; } .kb-wrapper .steps-list li::before { content: counter(steps); flex-shrink: 0; width: 26px; height: 26px; background: #032D42; color: #63DF4E; border-radius: 50%; font-size: 12px; font-weight: 900; display: flex; align-items: center; justify-content: center; margin-top: 2px; font-family: Lato, sans-serif; } .kb-wrapper .related-list { list-style: none; padding-left: 0; display: flex; flex-direction: column; gap: 8px; } .kb-wrapper .related-list li { background: #e8fce4; border: 1px solid #a8dfa0; border-radius: 6px; padding: 10px 14px; margin-bottom: 0; } .kb-wrapper .related-list li a { color: #032D42; text-decoration: none; font-size: 12pt; font-weight: 700; font-family: Lato, sans-serif; } .kb-wrapper .related-list li a:hover { text-decoration: underline; color: #0057a8; } .kb-wrapper .link-disclaimer { display: block; font-size: 10pt; font-style: italic; color: #3d5a6a; margin-top: 4px; font-family: Lato, sans-serif; line-height: 1.5; } .kb-wrapper hr.section-divider { border: none; border-top: 1px solid #d0dbe0; margin: 30px 0; } Issue / Question A customer's host OS is constrained to Amazon Linux 2023, which is not on the list of supported operating systems for a bare-metal MID Server installation. The customer is asking whether there is a supported path to run a MID Server in this environment. Symptoms The customer's environment uses Amazon Linux 2023 as the host OS.Amazon Linux 2023 is not listed as a supported OS for a standard MID Server installation.The customer needs a supported path to deploy a MID Server on this host. Facts As of the Rome release, ServiceNow officially supports a containerized MID Server and provides the Docker recipe to build it. This is a fully supported deployment method, not a workaround.With a containerized MID Server, the host OS requirements shift significantly. The MID Server runs inside a Linux container built from ServiceNow's official Docker recipe. The container image has its own internal OS and dependencies baked in, independent of the host OS.The host OS only needs to be capable of running Docker — it does not need to be one of the MID Server supported Linux distributions.Docker is fully supported on Amazon Linux 2023, making a containerized MID Server deployment a supported option on that host OS.As of the Washington DC release, containerized Windows MID Servers are no longer available. Only the Linux Docker Recipe remains available. This deployment path is Linux only.The official Linux Docker Recipe must be used to build the container image. The recipe is downloaded directly from the instance via MID Server > Downloads. Third-party images are not supported.The Docker recipes only work with the MID Server installation ZIP files. The official recipe must be used to build the image — it cannot be substituted with a custom or community-built image. Cause Amazon Linux 2023 is not a supported OS for a bare-metal MID Server installation. However, this constraint does not apply to a containerized deployment. Because the MID Server runs inside a container with its own internal OS and dependencies, the host OS requirement is limited to Docker compatibility rather than MID Server OS support. Amazon Linux 2023 meets this requirement. Solution Deploy the MID Server as a container on the Amazon Linux 2023 host using ServiceNow's official Linux Docker Recipe. This is the supported path for environments where the host OS is constrained to Amazon Linux 2023. Linux Only As of the Washington DC release, only the Linux Docker Recipe is available. Containerized Windows MID Servers are no longer supported. Ensure the deployment environment is Linux before proceeding. Confirm Docker is installed and running on the Amazon Linux 2023 host. Verify that Docker Engine is installed and the service is active before proceeding with the MID Server container build. Download the official Linux Docker Recipe from the instance. Navigate to MID Server > Downloads on the ServiceNow instance and download the Linux Docker Recipe. Do not use third-party or community images. Download the MID Server installation ZIP file. The Docker recipe requires the MID Server installation ZIP. Download the appropriate ZIP for the instance version from MID Server > Downloads. The recipe will not work without it. Build the container image using the official recipe. Follow the instructions included with the Docker Recipe to build the MID Server container image using the downloaded installation ZIP. Deploy and validate the containerized MID Server. Start the container and confirm the MID Server connects to the instance successfully. Validate in MID Server > MID Servers that the MID Server appears and its status is Up. Note The containerized MID Server is a fully supported deployment method as of the Rome release. For additional deployment guidance, refer to the Related Links below. Related Links MID Server System RequirementsContainerized MID ServersDeploying a Containerized MID Server in a Kubernetes Cluster This link points to a ServiceNow Community article. Community content is not official ServiceNow documentation and may be updated or removed without notice.MID Server Docker Recipe – Installation ZIP RequirementInstant MID Server with Docker on Windows (Windows Containerized MID Server Deprecation) This link points to a ServiceNow Community article. Community content is not official ServiceNow documentation and may be updated or removed without notice.