Add how to develop with Podman instead of Docker #2927

teresaromero · 2025-09-18T12:24:35Z

Partially Resolves #1748

Adding how-to guide to develop using podman desktop.

jsoriano

Thanks for confirming that elastic-package can work with podman!

Added some suggestions, I think we should focus the document more on how elastic-package can be used with podman, and less on documenting podman itself.

docs/howto/use_podman.md

mrodm · 2025-09-18T13:47:11Z

docs/howto/use_podman.md

@@ -0,0 +1,8 @@
+# How to Develop Using Podman Instead of Docker


Could it be linked this document from the main README?
https://github.com/elastic/elastic-package/blob/a4dc5bfc8e2e7d8bee92dca953ff4d533646f5ed/tools/readme/readme.md.tmpl

I don't see any reference that elastic-package required docker, but maybe it could be added in the Getting started section, WDYT?

As an example, this is done in the integrations repo: https://github.com/elastic/integrations/blob/30cbfa897b15730214495befe29929e9d218c122/docs/extend/quick-start.md?plain=1#L33

i see it in the stack command is mentioned that is a "docker-based" command https://github.com/elastic/elastic-package/blob/a4dc5bfc8e2e7d8bee92dca953ff4d533646f5ed/README.md#elastic-package-stack perhaps here we could add a line just in case you dont use docker ?

i see it in the stack command is mentioned that is a "docker-based" command https://github.com/elastic/elastic-package/blob/a4dc5bfc8e2e7d8bee92dca953ff4d533646f5ed/README.md#elastic-package-stack perhaps here we could add a line just in case you dont use docker ?

Maybe the line you added to elastic-package stack up could be removed in favor of the one in elastic-package stack.

But a part from the stack sub-command, other sub-commands also require docker commands:

elastic-package test system

elastic-package service

So, I'm wondering if it would make sense to just add it to a section in the main README.md as Requirements, Pre-Requisites or under "Getting started". WDYT @jsoriano ?

I would add it to getting started section, although adding it to the command description might be useful in case of error, looking for help of the command can be a way to discover this content too

I think it would be enough with the mention in the getting started section, but I don't see a problem with the line added to command descriptions, so as you prefer.

jsoriano · 2025-09-19T13:26:18Z

docs/howto/use_podman.md

@@ -0,0 +1,8 @@
+# How to Develop Using Podman Instead of Docker


I think it would be enough with the mention in the getting started section, but I don't see a problem with the line added to command descriptions, so as you prefer.

jsoriano · 2025-09-19T13:27:29Z

docs/howto/use_podman.md

@@ -0,0 +1,8 @@
+# How to Develop Using Podman Instead of Docker
+
+`elastic-package` Docker-based commands should work out of the box using Podman instead of Docker.


It'd be great to add a test to prove this 🙂 but we can add it if at some point we see users having problems with Podman.

docs/howto/use_podman.md

efd6 · 2025-09-21T22:52:46Z

Following the instructions in the linked pages I was unable to get elastic-package to bring up a stack using podman.

teresaromero · 2025-09-22T07:12:57Z

Following the instructions in the linked pages I was unable to get elastic-package to bring up a stack using podman.

Could you share what was the error? Thanks

…arity

Co-authored-by: Mario Rodriguez Molins <marrodmo@gmail.com>

efd6 · 2025-09-22T07:26:08Z

Failed to check status of the stack after failure: error getting containers with label "com.docker.compose.project=elastic-package-stack" (stderr="Cannot connect to the Docker daemon at unix:///…/.docker/desktop/docker.sock. Is the docker daemon running?\n"): exit status 1 thought it's worse now. I cannot get any of it to work. Have you demonstrated it working?

teresaromero · 2025-09-22T12:29:47Z

Failed to check status of the stack after failure: error getting containers with label "com.docker.compose.project=elastic-package-stack" (stderr="Cannot connect to the Docker daemon at unix:///…/.docker/desktop/docker.sock. Is the docker daemon running?\n"): exit status 1 thought it's worse now. I cannot get any of it to work. Have you demonstrated it working?

I am currently using Podman to use elastic package commands, so i have been able to make it work.

Can you check the active Docker CLI context is correctly selected? For my current setup i use the default one (unix:///var/run/docker.sock) Here you have further details on how to verify your docker migration

teresaromero · 2025-09-23T09:16:22Z

Moving back to draft as there is indeed some missing instructions to make this work without podman desktop.

link fixed

teresaromero · 2025-10-07T13:50:21Z

@efd6 Hi Dan! I've been around this setup without Podman Desktop i cant seem to make it work. What do you think of adding this small how-to as a reference and keep the issue open?

Where you able to make it work with the instructions with Podman Desktop?

elasticmachine · 2025-10-07T14:46:48Z

💚 Build Succeeded

Buildkite Build
Commit: 5428508

History

💚 Build #6186 succeeded f044127
💚 Build #6168 succeeded d86191c

efd6 · 2025-10-07T20:03:35Z

I have not been able to make this work. I'd be reluctant to merge this without significant caveats, I'm not sure it's worth it at this stage.

jsoriano

As these instructions require Podman Desktop I would be more specific about this, and keep the issue open for further improvements. When we add support Podman CLI, we can revisit this.

jsoriano · 2025-10-08T10:54:09Z

docs/howto/use_podman.md

@@ -0,0 +1,8 @@
+# How to Develop Using Podman Instead of Docker


Let's be more specific about using Podman Desktop. Podman CLI doens't seem to be enough for the calls to the API as the socket is not exposed.

Suggested change

# How to Develop Using Podman Instead of Docker

# How to Develop Using Podman Desktop Instead of Docker

jsoriano · 2025-10-08T10:54:28Z

cmd/stack.go


 Be aware that a common issue while trying to boot up the stack is that your Docker environments settings are too low in terms of memory threshold.

+You can use Podman instead of Docker, see [this document](./docs/howto/use_podman.md)


Suggested change

You can use Podman instead of Docker, see [this document](./docs/howto/use_podman.md)

You can use Podman Desktop instead of Docker, see [this document](./docs/howto/use_podman.md)

jsoriano · 2025-10-08T10:54:38Z

cmd/stack.go


 Be aware that a common issue while trying to boot up the stack is that your Docker environments settings are too low in terms of memory threshold.

+You can use Podman instead of Docker, see [this document](./docs/howto/use_podman.md)


Suggested change

You can use Podman instead of Docker, see [this document](./docs/howto/use_podman.md)

You can use Podman Desktop instead of Docker, see [this document](./docs/howto/use_podman.md)

jsoriano · 2025-10-08T10:54:56Z

docs/howto/use_podman.md

@@ -0,0 +1,8 @@
+# How to Develop Using Podman Instead of Docker
+
+`elastic-package` Docker-based commands should work out of the box using Podman instead of Docker.


Suggested change

`elastic-package` Docker-based commands should work out of the box using Podman instead of Docker.

`elastic-package` Docker-based commands should work out of the box using Podman Desktop instead of Docker.

jsoriano · 2025-10-08T10:55:12Z

tools/readme/readme.md.tmpl

 elastic-package help
 ```

+Some sub-commands are Docker-based, check you also have Docker installed. In case you are using Podman, check [this guide](./docs/howto/use_podman.md) to make it compatible.


Suggested change

Some sub-commands are Docker-based, check you also have Docker installed. In case you are using Podman, check [this guide](./docs/howto/use_podman.md) to make it compatible.

Some sub-commands are Docker-based, check you also have Docker installed. In case you are using Podman Desktop, check [this guide](./docs/howto/use_podman.md) to make it compatible.

jsoriano reviewed Sep 18, 2025

View reviewed changes

docs/howto/use_podman.md Outdated Show resolved Hide resolved

docs/howto/use_podman.md Outdated Show resolved Hide resolved

mrodm reviewed Sep 18, 2025

View reviewed changes

teresaromero force-pushed the how-to-podman branch from 1d79a0b to d86191c Compare September 19, 2025 07:30

teresaromero changed the title ~~Add guide for developing with Podman instead of Docker~~ Add how to developing with Podman instead of Docker Sep 19, 2025

teresaromero changed the title ~~Add how to developing with Podman instead of Docker~~ Add how to develop with Podman instead of Docker Sep 19, 2025

jsoriano approved these changes Sep 19, 2025

View reviewed changes

efd6 previously requested changes Sep 21, 2025

View reviewed changes

docs/howto/use_podman.md Outdated Show resolved Hide resolved

teresaromero and others added 6 commits September 22, 2025 09:19

Add guide for developing with Podman instead of Docker

ff921ae

Refactor Podman usage guide to streamline instructions and enhance cl…

c741992

…arity

Update docs/howto/use_podman.md

2920a2c

Co-authored-by: Mario Rodriguez Molins <marrodmo@gmail.com>

Update documentation to include Podman as an alternative to Docker

bcee060

Add note about Docker and Podman compatibility in README

bd4f593

Fix links to podman docs and getting started

f044127

teresaromero force-pushed the how-to-podman branch from cd36ea8 to f044127 Compare September 22, 2025 07:19

teresaromero marked this pull request as draft September 23, 2025 09:15

teresaromero added 2 commits October 7, 2025 15:36

Merge branch 'main' into how-to-podman

3ad1122

docs: emphasize Podman Desktop configuration in usage guide

5428508

teresaromero marked this pull request as ready for review October 7, 2025 13:47

jsoriano reviewed Oct 8, 2025

View reviewed changes

		@@ -0,0 +1,8 @@
		# How to Develop Using Podman Instead of Docker

		@@ -0,0 +1,8 @@
		# How to Develop Using Podman Instead of Docker

		`elastic-package` Docker-based commands should work out of the box using Podman instead of Docker.

	# How to Develop Using Podman Instead of Docker
	# How to Develop Using Podman Desktop Instead of Docker


		Be aware that a common issue while trying to boot up the stack is that your Docker environments settings are too low in terms of memory threshold.

		You can use Podman instead of Docker, see [this document](./docs/howto/use_podman.md)

	You can use Podman instead of Docker, see [this document](./docs/howto/use_podman.md)
	You can use Podman Desktop instead of Docker, see [this document](./docs/howto/use_podman.md)

	Some sub-commands are Docker-based, check you also have Docker installed. In case you are using Podman, check [this guide](./docs/howto/use_podman.md) to make it compatible.
	Some sub-commands are Docker-based, check you also have Docker installed. In case you are using Podman Desktop, check [this guide](./docs/howto/use_podman.md) to make it compatible.

Add how to develop with Podman instead of Docker #2927

Are you sure you want to change the base?

Add how to develop with Podman instead of Docker #2927

Uh oh!

Conversation

teresaromero commented Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jsoriano left a comment

Choose a reason for hiding this comment

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!

Uh oh!

efd6 commented Sep 21, 2025

Uh oh!

teresaromero commented Sep 22, 2025

Uh oh!

efd6 commented Sep 22, 2025

Uh oh!

teresaromero commented Sep 22, 2025

Uh oh!

teresaromero commented Sep 23, 2025

Uh oh!

teresaromero commented Oct 7, 2025

Uh oh!

elasticmachine commented Oct 7, 2025

💚 Build Succeeded

History

Uh oh!

efd6 commented Oct 7, 2025

Uh oh!

jsoriano 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!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

teresaromero commented Sep 18, 2025 •

edited

Loading