Docker on plesk by DMuirheadLayershift · Pull Request #162 · layershift/kb-layershift

DMuirheadLayershift · 2026-07-28T14:50:00Z

KB Docker article, alongside attendant images.

And a reversion for a file that shouldnt have been edited.

chapter file added

Plesk Docker Article

doc file previously incomplete. Updating, might need to add images.

Reversion to original work.

Add CL preq. already amended on doc dev site.

dransome

Mostly needs better alt text, but a few points require tidying up a bit as well.

dransome · 2026-07-28T15:10:10Z

+  Search for your desired application image > Select specific image > Select version. 
+
+
+   ![ValkeySearch](ValkeySearch.png "ValkeySearch")


Please make the alt text more descriptive and specific. For example:

Screenshot of Plesk Docker extension showing search results for valkey.

Done.
The word tag was mentioned specifically since it a key technical word.

Unclear what was done? Alt text for the image seems to be unchanged?

Valkey image search results, with the selected image highlighted in purple

dransome · 2026-07-28T15:25:59Z

+
+If it fails, you will receive an error message in the top right corner of your dashboard.
+
+![restartcontainer](restartcontainer.png "restartcontainer")


Please make the alt text more descriptive and specific

Image showing the Stopped state and the Start state of containers

dransome · 2026-07-28T15:26:15Z

+
+When that file is in place, recreate your web facing container.
+
+![lb-recreate](lb-recreate.png "lb-recreate")


Please make the alt text more descriptive and specific

Screenshot of NGINX lb container details, with the hamburger many highlighted in purple and the Recreate button higlighted in green

dransome · 2026-07-28T15:26:20Z

+
+Stopping or removing a stack can be done through the highlighted button below.
+
+![stack%20removal](stack%20removal.png "stack%20removal")


Please make the alt text more descriptive and specific

Screenshot of the demo-stack details, with purple highlighted hamburger menu showing the options Deploy, Watch, Stop and Destroy

dransome · 2026-07-28T15:48:43Z

+We do offer support for the setup of Docker on Plesk, Plesk and server related issues you may experience while installing and operating your containers.
+
+##   License
+Should you wish to manage multiple Docker servers from a single point, you will need to purchase the Remote Docker license. For more information please see the documentation or contact Support.


I think including this kind of complicates life a bit more than necessary, but if we're stating it I think we can do so more clearly:

A paid license option is available to enable you to manage Docker containers hosted on multiple different servers from a single interface (please contact billing@layershift.com for assistance), but managing containers hosted locally by a single Layershift Managed VPS is included at no additional cost.

Unsure if this is precise enough:

from a single point

However, I don't currently have a better phrase in mind.

For more information please see the documentation or contact Support.

I dislike this (it's inaccurate). Please use my proposed wording:

(please contact billing@layershift.com for assistance)

Changed to quote.

DMuirheadLayershift · 2026-07-29T19:17:44Z

Small basic comment, I had made all the changes. Forgot to push commit before closing the windows and going to handle a ticket.

If something seems like it should be there and it isnt. Please bare with me

Not finished, re-doing my updates. If something is not there, it will be tomorrow.

dransome

I think you misunderstood the image alt text requests. Please review https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/alt

Which in markdown means:
https://www.markdownlang.com/basic/images.html#best-practices-for-alt-text

dransome · 2026-07-30T09:02:44Z

-
-
-![Extension%20Installation](Extension%20Installation.png "Extension%20Installation")
+Docker comes pre-installed on all Layershift Plesk servers, so no need for installation. Just look to the left hand panel and you should an option labelled Docker.   


Typo:

should an option

"see" inserted.

dransome · 2026-07-30T09:04:02Z

+  Search for your desired application image > Select specific image > Select version. 
+
+
+   ![ValkeySearch](ValkeySearch.png "ValkeySearch")


Unclear what was done? Alt text for the image seems to be unchanged?

dransome · 2026-07-30T09:06:50Z

+
+Docker uses the term "Tag" to refer to the version details of a particular image. The version is split into both the numbered version (9.1.0 below) and the named version. Alpine, Trixie, rc2 in the image below.
+
+If you are uncertain which version, use "latest"


I consider this to be bad advice. Using "latest" is dangerous because what is "latest" when you deploy it becomes unclear later.

It's recommended best practice to avoid using "latest" and instead always use an explicit named version; that way you can see exactly what version you have deployed at any moment just by looking at the tag (which will prove to be important information to know for compatibility and security reasons).

I guess I got bad advice before. Fair enough.

Edited.

dransome · 2026-07-30T09:08:22Z

-
-
+
+Docker uses the term "Tag" to refer to the version details of a particular image. The version is split into both the numbered version (9.1.0 below) and the named version. Alpine, Trixie, rc2 in the image below.


The naming scheme for Docker tags is entirely arbitrary (up to the image author's choice), so I don't think we should attempt to explain it.

explanation removed

dransome · 2026-07-30T09:08:45Z

+   ![ValkeySearch](ValkeySearch.png "ValkeySearch")
+
+
+   ![ValkeyVersion](ValkeyVersion.png "ValkeyVersion")


Image alt text appears to be unchanged?

dransome · 2026-07-30T09:34:42Z

+
+Should you wish to run a docker-compose.yaml file and setup a whole stack like the below. There are multiple ways you can upload your compose file.
+
+![stack](stack.png "stack")


The image alt text is the problem.

dransome · 2026-07-30T09:36:58Z

+We do offer support for the setup of Docker on Plesk, Plesk and server related issues you may experience while installing and operating your containers.
+
+##   License
+Should you wish to manage multiple Docker servers from a single point, you will need to purchase the Remote Docker license. For more information please see the documentation or contact Support.


Unsure if this is precise enough:

from a single point

However, I don't currently have a better phrase in mind.

For more information please see the documentation or contact Support.

I dislike this (it's inaccurate). Please use my proposed wording:

(please contact billing@layershift.com for assistance)

dransome · 2026-07-30T09:37:48Z

We can make this unambiguous by inserting local here:

You do not need a license to manage the local Docker service running on your Layershift Plesk server.

Caveat added and rewording on licensing done.

dransome · 2026-07-30T10:09:04Z

-Manual port binding is available if the "Automatic port mapping" button is deselected. You can set both the port you wish inside and outside the container and if you wish the port to accessible from the internet. It is always accessible from the server(127.0.0.1)
+Manual port binding is available if the "Automatic port mapping" button is deselected. You can set both the port you wish inside and outside the container and if you wish the port to accessible from the internet. It is always accessible from the server (127.0.0.1)
+
+ You may have issues with pre-existing services or other containers already using a particular port. This is called a Port Clash and you can mitigate it through using manual port mapping  and setting the port to an appropriate IP.


I think the port conflict issue needs to be formatted as a warning, and can probably be slimmed down a bit.

I also recommend to separate the issue of automatic vs. manual port binding (i.e. when to use which one) vs. how to decide which port can be used (if selecting a manual one).

Finally, is the "how to select a port number" guidance the best we can do? Reading it, I'm honestly not sure how to decide what port to use, and what happens if I get it wrong. Can we try to come up with something that's easier for the customer to follow / apply?

Warning added.
The word IP was in there, changed to value.

I dont think we can be prescriptive on what port a customer should use, the best we can do is give them the information. At least, I don't know of any particular advice on port selection.
At times i've incremented for multiple of the same service, other times you use the port number again (8080, 2222).

I've done some minor changes, but im going to come and look at this with fresh eyes tomorrow.

Alt texts updated. Not finished all edits, just the alt text.

On Volume Mapping. COmmitting while I do a ticket.

All done except Port Mapping, which will be re-written tomorrow.

Going Further, Port Mapping.

dransome

I used suggestions which should hopefully make it easier to just accept changes on most of it.

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Troubleshooting added to Docker-Compose container_settings image put in correct pace.

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Docker Compose section re-jiggered.

DMuirheadLayershift added 6 commits July 8, 2026 15:55

Create chapter.en.md

f3a2a52

chapter file added

Create docs.en.md

d4a95b4

Plesk Docker Article

Plesk Docker Images

ba2a340

Update docs.en.md

fe40b2c

doc file previously incomplete. Updating, might need to add images.

Update docs.en.md

40e6d2c

Reversion to original work.

Update docs.en.md

b29c522

Add CL preq. already amended on doc dev site.

DMuirheadLayershift assigned dransome Jul 28, 2026

dransome removed their assignment Jul 28, 2026

dransome self-requested a review July 28, 2026 14:58

dransome requested changes Jul 28, 2026

View reviewed changes

dransome assigned DMuirheadLayershift Jul 28, 2026

Update docs.en.md

a9bd00f

Not finished, re-doing my updates. If something is not there, it will be tomorrow.

dransome requested changes Jul 30, 2026

View reviewed changes

DMuirheadLayershift added 4 commits July 30, 2026 18:20

Update docs.en.md

ccabf8a

Alt texts updated. Not finished all edits, just the alt text.

Update docs.en.md

ee04ff3

On Volume Mapping. COmmitting while I do a ticket.

Update docs.en.md

5d2a93a

All done except Port Mapping, which will be re-written tomorrow.

Update docs.en.md

190b183

Going Further, Port Mapping.

DMuirheadLayershift requested a review from dransome August 3, 2026 21:13

dransome requested changes Aug 4, 2026

View reviewed changes

DMuirheadLayershift and others added 10 commits August 4, 2026 23:50

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

8e10b54

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

5155754

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

e5249b8

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

7013770

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

47012e8

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

ff04c26

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

fc38675

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

b1429c2

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

ccc85db

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

1fbb46c

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

DMuirheadLayershift and others added 12 commits August 4, 2026 23:59

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

016d70d

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update docs.en.md

09cd2d6

Troubleshooting added to Docker-Compose container_settings image put in correct pace.

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

8ea035f

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

0fed1e1

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

6931f09

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

cdce3be

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

2a0bf6c

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

b1e57b8

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

cea8f7d

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

3c6a37b

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update pages/02.managed-vps/07.docker/01.docker-on-plesk/docs.en.md

e504f38

Co-authored-by: Damien Ransome <dransome@users.noreply.github.com>

Update docs.en.md

3bc0b42

Docker Compose section re-jiggered.

DMuirheadLayershift requested a review from dransome August 4, 2026 21:26

		Search for your desired application image > Select specific image > Select version.


		![ValkeySearch](ValkeySearch.png "ValkeySearch")


		If it fails, you will receive an error message in the top right corner of your dashboard.

		![restartcontainer](restartcontainer.png "restartcontainer")


		When that file is in place, recreate your web facing container.

		![lb-recreate](lb-recreate.png "lb-recreate")


		Stopping or removing a stack can be done through the highlighted button below.

		![stack%20removal](stack%20removal.png "stack%20removal")



		![Extension%20Installation](Extension%20Installation.png "Extension%20Installation")
		Docker comes pre-installed on all Layershift Plesk servers, so no need for installation. Just look to the left hand panel and you should an option labelled Docker.


		Docker uses the term "Tag" to refer to the version details of a particular image. The version is split into both the numbered version (9.1.0 below) and the named version. Alpine, Trixie, rc2 in the image below.

		If you are uncertain which version, use "latest"

		![ValkeySearch](ValkeySearch.png "ValkeySearch")


		![ValkeyVersion](ValkeyVersion.png "ValkeyVersion")


		Should you wish to run a docker-compose.yaml file and setup a whole stack like the below. There are multiple ways you can upload your compose file.

		![stack](stack.png "stack")

Uh oh!

Conversation

DMuirheadLayershift commented Jul 28, 2026

Uh oh!

dransome left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

DMuirheadLayershift commented Jul 29, 2026

Uh oh!

dransome left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dransome left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!