11---
2- description : Learn how to install Docker Engine on SLES. These instructions cover
3- the different installation methods, how to uninstall, and next steps.
4- keywords : requirements, apt, installation, install docker engine, centos, rpm, sles, install, uninstall,
5- upgrade, update, s390x, ibm-z
6- title : Install Docker Engine on SLES (s390x)
2+ description : Information about Docker Engine availability on SLES. Docker packages are no longer available for SLES s390x architecture.
3+ keywords : sles, install, uninstall, upgrade, update, s390x, ibm-z, not supported, unavailable
4+ title : Docker Engine on SLES (s390x)
75linkTitle : SLES (s390x)
86weight : 70
97toc_max : 4
@@ -23,245 +21,36 @@ aliases:
2321- /install/linux/docker-ee/suse/
2422- /install/linux/sles/
2523- /installation/sles/
26- download-url-base : https://download.docker.com/linux/sles
2724---
2825
29- > [ !NOTE]
30- >
31- > The installation instructions on this page refer to packages for SLES on the
32- > ** s390x** architecture (IBM Z). Other architectures, including x86_64, aren't
33- > supported for SLES.
34-
35- To get started with Docker Engine on SLES, make sure you
36- [ meet the prerequisites] ( #prerequisites ) , and then follow the
37- [ installation steps] ( #installation-methods ) .
38-
39- ## Prerequisites
40-
41- ### OS requirements
42-
43- To install Docker Engine, you need a maintained version of one of the following
44- SLES versions:
45-
46- - SLES 15-SP4 on s390x (IBM Z)
47- - SLES 15-SP5 on s390x (IBM Z)
48-
49- You must enable the [ ` SCC SUSE ` ] ( https://scc.suse.com/packages?name=SUSE%20Linux%20Enterprise%20Server&version=15.5&arch=s390x )
50- repositories.
51-
52- You must add the [ OpenSUSE ` SELinux ` repository] ( https://download.opensuse.org/repositories/security:/SELinux/ ) . This repository is not added by default. Run the following commands to add it:
53-
54- ``` console
55- $ opensuse_repo=" https://download.opensuse.org/repositories/security:/SELinux/openSUSE_Factory/security:SELinux.repo"
56- $ sudo zypper addrepo $opensuse_repo
57- ```
58-
59- ### Uninstall old versions
60-
61- Before you can install Docker Engine, you need to uninstall any conflicting packages.
62-
63- Your Linux distribution may provide unofficial Docker packages, which may conflict
64- with the official packages provided by Docker. You must uninstall these packages
65- before you install the official version of Docker Engine.
66-
67- ``` console
68- $ sudo zypper remove docker \
69- docker-client \
70- docker-client-latest \
71- docker-common \
72- docker-latest \
73- docker-latest-logrotate \
74- docker-logrotate \
75- docker-engine \
76- runc
77- ```
78-
79- ` zypper ` might report that you have none of these packages installed.
80-
81- Images, containers, volumes, and networks stored in ` /var/lib/docker/ ` aren't
82- automatically removed when you uninstall Docker.
83-
84- ## Installation methods
85-
86- You can install Docker Engine in different ways, depending on your needs:
87-
88- - You can
89- [ set up Docker's repositories] ( #install-using-the-repository ) and install
90- from them, for ease of installation and upgrade tasks. This is the
91- recommended approach.
92-
93- - You can download the RPM package,
94- [ install it manually] ( #install-from-a-package ) , and manage
95- upgrades completely manually. This is useful in situations such as installing
96- Docker on air-gapped systems with no access to the internet.
97-
98- - In testing and development environments, you can use automated
99- [ convenience scripts] ( #install-using-the-convenience-script ) to install Docker.
100-
101- ### Install using the rpm repository {#install-using-the-repository}
102-
103- Before you install Docker Engine for the first time on a new host machine, you
104- need to set up the Docker repository. Afterward, you can install and update
105- Docker from the repository.
106-
107- #### Set up the repository
108-
109- Set up the repository.
110-
111- ``` console
112- $ sudo zypper addrepo {{% param " download-url-base" %}}/docker-ce.repo
113- ```
114-
115- #### Install Docker Engine
116-
117- 1 . Install the Docker packages.
118-
119- {{< tabs >}}
120- {{< tab name="Latest" >}}
121-
122- To install the latest version, run:
123-
124- ``` console
125- $ sudo zypper install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
126- ```
127-
128- If prompted to accept the GPG key, verify that the fingerprint matches
129- ` 060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35 ` , and if so, accept it.
130-
131- This command installs Docker, but it doesn't start Docker. It also creates a
132- ` docker ` group, however, it doesn't add any users to the group by default.
133-
134- {{< /tab >}}
135- {{< tab name="Specific version" >}}
136-
137- To install a specific version, start by listing the available versions in
138- the repository:
139-
140- ``` console
141- $ sudo zypper search -s --match-exact docker-ce | sort -r
142-
143- v | docker-ce | package | 3:{{% param "docker_ce_version" %}}-1 | s390x | Docker CE Stable - s390x
144- v | docker-ce | package | 3:{{% param "docker_ce_version_prev" %}}-1 | s390x | Docker CE Stable - s390x
145- ```
26+ ## Docker Engine is no longer available for SLES
14627
147- The list returned depends on which repositories are enabled, and is specific
148- to your version of SLES.
149-
150- Install a specific version by its fully qualified package name, which is
151- the package name (` docker-ce ` ) plus the version string (2nd column),
152- separated by a hyphen (` - ` ). For example, ` docker-ce-3:{{% param "docker_ce_version" %}} ` .
153-
154- Replace ` <VERSION_STRING> ` with the desired version and then run the following
155- command to install:
156-
157- ``` console
158- $ sudo zypper install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin
159- ```
160-
161- This command installs Docker, but it doesn't start Docker. It also creates a
162- ` docker ` group, however, it doesn't add any users to the group by default.
163-
164- {{< /tab >}}
165- {{< /tabs >}}
166-
167- 2 . Start Docker Engine.
168-
169- ``` console
170- $ sudo systemctl enable --now docker
171- ```
172-
173- This configures the Docker systemd service to start automatically when you
174- boot your system. If you don't want Docker to start automatically, use `sudo
175- systemctl start docker` instead.
176-
177- 3 . Verify that the installation is successful by running the ` hello-world ` image:
178-
179- ``` console
180- $ sudo docker run hello-world
181- ```
182-
183- This command downloads a test image and runs it in a container. When the
184- container runs, it prints a confirmation message and exits.
185-
186- You have now successfully installed and started Docker Engine.
187-
188- {{% include "root-errors.md" %}}
189-
190- #### Upgrade Docker Engine
191-
192- To upgrade Docker Engine, follow the [ installation instructions] ( #install-using-the-repository ) ,
193- choosing the new version you want to install.
194-
195- ### Install from a package
196-
197- If you can't use Docker's ` rpm ` repository to install Docker Engine, you can
198- download the ` .rpm ` file for your release and install it manually. You need to
199- download a new file each time you want to upgrade Docker Engine.
200-
201- <!-- markdownlint-disable-next-line -->
202- 1 . Go to [ {{% param "download-url-base" %}}/] ({{% param "download-url-base" %}}/)
203- and choose your version of SLES. Then browse to ` s390x/stable/Packages/ `
204- and download the ` .rpm ` file for the Docker version you want to install.
205-
206- 2 . Install Docker Engine, changing the following path to the path where you downloaded
207- the Docker package.
208-
209- ``` console
210- $ sudo zypper install /path/to/package.rpm
211- ```
212-
213- Docker is installed but not started. The ` docker ` group is created, but no
214- users are added to the group.
215-
216- 3 . Start Docker Engine.
217-
218- ``` console
219- $ sudo systemctl enable --now docker
220- ```
221-
222- This configures the Docker systemd service to start automatically when you
223- boot your system. If you don't want Docker to start automatically, use `sudo
224- systemctl start docker` instead.
225-
226- 4 . Verify that the installation is successful by running the ` hello-world ` image:
227-
228- ``` console
229- $ sudo docker run hello-world
230- ```
231-
232- This command downloads a test image and runs it in a container. When the
233- container runs, it prints a confirmation message and exits.
234-
235- You have now successfully installed and started Docker Engine.
236-
237- {{% include "root-errors.md" %}}
238-
239- #### Upgrade Docker Engine
240-
241- To upgrade Docker Engine, download the newer package files and repeat the
242- [ installation procedure] ( #install-from-a-package ) , using ` zypper -y upgrade `
243- instead of ` zypper -y install ` , and point to the new files.
244-
245- {{% include "install-script.md" %}}
28+ > [ !IMPORTANT]
29+ >
30+ > Docker Engine packages are ** no longer available** for SUSE Linux Enterprise Server (SLES) on the ** s390x** architecture (IBM Z).
24631
247- ## Uninstall Docker Engine
32+ IBM has made the decision to discontinue building and providing Docker Engine
33+ packages for SLES s390x systems. Docker Inc. never directly built these packages
34+ and was only involved in their deployment.
24835
249- 1 . Uninstall the Docker Engine, CLI, containerd, and Docker Compose packages:
36+ ## What this means
25037
251- ``` console
252- $ sudo zypper remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
253- ```
38+ - New Docker Engine installations are not available for SLES s390x
39+ - Existing installations will continue to work but will not receive updates
40+ - No new versions or security updates will be provided
41+ - The Docker package repository for SLES s390x is no longer maintained
25442
255- 2 . Images, containers, volumes, or custom configuration files on your host
256- aren't automatically removed. To delete all images, containers, and volumes:
43+ ## If you have Docker currently installed
25744
258- ``` console
259- $ sudo rm -rf /var/lib/docker
260- $ sudo rm -rf /var/lib/containerd
261- ```
45+ If you currently have Docker Engine installed on a SLES s390x system:
26246
263- You have to delete any edited configuration files manually.
47+ - Your existing Docker installation will continue to function
48+ - No automatic updates will be available
49+ - You should plan accordingly for your containerization needs
50+ - Consider the security implications of running software without updates
26451
26552## Next steps
26653
267- - Continue to [ Post-installation steps for Linux] ( linux-postinstall.md ) .
54+ For questions about this decision or alternative solutions, contact IBM support.
55+
56+ ---
0 commit comments