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,247 +21,35 @@ 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- {{% include "engine-license.md" %}}
102-
103- ### Install using the rpm repository {#install-using-the-repository}
104-
105- Before you install Docker Engine for the first time on a new host machine, you
106- need to set up the Docker repository. Afterward, you can install and update
107- Docker from the repository.
108-
109- #### Set up the repository
110-
111- Set up the repository.
112-
113- ``` console
114- $ sudo zypper addrepo {{% param " download-url-base" %}}/docker-ce.repo
115- ```
116-
117- #### Install Docker Engine
118-
119- 1 . Install the Docker packages.
120-
121- {{< tabs >}}
122- {{< tab name="Latest" >}}
123-
124- To install the latest version, run:
125-
126- ``` console
127- $ sudo zypper install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
128- ```
129-
130- If prompted to accept the GPG key, verify that the fingerprint matches
131- ` 060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35 ` , and if so, accept it.
132-
133- This command installs Docker, but it doesn't start Docker. It also creates a
134- ` docker ` group, however, it doesn't add any users to the group by default.
135-
136- {{< /tab >}}
137- {{< tab name="Specific version" >}}
138-
139- To install a specific version, start by listing the available versions in
140- the repository:
141-
142- ``` console
143- $ sudo zypper search -s --match-exact docker-ce | sort -r
26+ ## Docker Engine is no longer available for SLES
14427
145- v | docker-ce | package | 3:{{% param "docker_ce_version" %}}-1 | s390x | Docker CE Stable - s390x
146- v | docker-ce | package | 3:{{% param "docker_ce_version_prev" %}}-1 | s390x | Docker CE Stable - s390x
147- ```
148-
149- The list returned depends on which repositories are enabled, and is specific
150- to your version of SLES.
151-
152- Install a specific version by its fully qualified package name, which is
153- the package name (` docker-ce ` ) plus the version string (2nd column),
154- separated by a hyphen (` - ` ). For example, ` docker-ce-3:{{% param "docker_ce_version" %}} ` .
155-
156- Replace ` <VERSION_STRING> ` with the desired version and then run the following
157- command to install:
158-
159- ``` console
160- $ sudo zypper install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin
161- ```
162-
163- This command installs Docker, but it doesn't start Docker. It also creates a
164- ` docker ` group, however, it doesn't add any users to the group by default.
165-
166- {{< /tab >}}
167- {{< /tabs >}}
168-
169- 2 . Start Docker Engine.
170-
171- ``` console
172- $ sudo systemctl enable --now docker
173- ```
174-
175- This configures the Docker systemd service to start automatically when you
176- boot your system. If you don't want Docker to start automatically, use `sudo
177- systemctl start docker` instead.
178-
179- 3 . Verify that the installation is successful by running the ` hello-world ` image:
180-
181- ``` console
182- $ sudo docker run hello-world
183- ```
184-
185- This command downloads a test image and runs it in a container. When the
186- container runs, it prints a confirmation message and exits.
187-
188- You have now successfully installed and started Docker Engine.
189-
190- {{% include "root-errors.md" %}}
191-
192- #### Upgrade Docker Engine
193-
194- To upgrade Docker Engine, follow the [ installation instructions] ( #install-using-the-repository ) ,
195- choosing the new version you want to install.
196-
197- ### Install from a package
198-
199- If you can't use Docker's ` rpm ` repository to install Docker Engine, you can
200- download the ` .rpm ` file for your release and install it manually. You need to
201- download a new file each time you want to upgrade Docker Engine.
202-
203- <!-- markdownlint-disable-next-line -->
204- 1 . Go to [ {{% param "download-url-base" %}}/] ({{% param "download-url-base" %}}/)
205- and choose your version of SLES. Then browse to ` s390x/stable/Packages/ `
206- and download the ` .rpm ` file for the Docker version you want to install.
207-
208- 2 . Install Docker Engine, changing the following path to the path where you downloaded
209- the Docker package.
210-
211- ``` console
212- $ sudo zypper install /path/to/package.rpm
213- ```
214-
215- Docker is installed but not started. The ` docker ` group is created, but no
216- users are added to the group.
217-
218- 3 . Start Docker Engine.
219-
220- ``` console
221- $ sudo systemctl enable --now docker
222- ```
223-
224- This configures the Docker systemd service to start automatically when you
225- boot your system. If you don't want Docker to start automatically, use `sudo
226- systemctl start docker` instead.
227-
228- 4 . Verify that the installation is successful by running the ` hello-world ` image:
229-
230- ``` console
231- $ sudo docker run hello-world
232- ```
233-
234- This command downloads a test image and runs it in a container. When the
235- container runs, it prints a confirmation message and exits.
236-
237- You have now successfully installed and started Docker Engine.
238-
239- {{% include "root-errors.md" %}}
240-
241- #### Upgrade Docker Engine
242-
243- To upgrade Docker Engine, download the newer package files and repeat the
244- [ installation procedure] ( #install-from-a-package ) , using ` zypper -y upgrade `
245- instead of ` zypper -y install ` , and point to the new files.
246-
247- {{% 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).
24831
249- ## 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.
25035
251- 1 . Uninstall the Docker Engine, CLI, containerd, and Docker Compose packages:
36+ ## What this means
25237
253- ``` console
254- $ sudo zypper remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
255- ```
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
25642
257- 2 . Images, containers, volumes, or custom configuration files on your host
258- aren't automatically removed. To delete all images, containers, and volumes:
43+ ## If you have Docker currently installed
25944
260- ``` console
261- $ sudo rm -rf /var/lib/docker
262- $ sudo rm -rf /var/lib/containerd
263- ```
45+ If you currently have Docker Engine installed on a SLES s390x system:
26446
265- 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
26651
26752## Next steps
26853
269- - Continue to [ Post-installation steps for Linux] ( linux-postinstall.md ) .
54+ For questions about this decision or alternative solutions, contact IBM support.
55+
0 commit comments