Add how to develop with Podman Desktop instead of Docker by teresaromero · Pull Request #2927 · elastic/elastic-package

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?

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.

docs/howto/use_podman.md

cmd/stack.go

docs/howto/use_podman.md

tools/readme/readme.md.tmpl

elasticmachine · 2025-10-15T14:40:29Z

💚 Build Succeeded

Buildkite Build
Commit: a876cfa

History

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

jsoriano

Great, thanks!

efd6 · 2025-10-16T19:33:48Z

These instructions did not work for me. I do not think this should have been merged as it is incomplete.

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

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

cmd/stack.go Outdated Show resolved Hide resolved

cmd/stack.go Outdated Show resolved Hide resolved

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

tools/readme/readme.md.tmpl Outdated Show resolved Hide resolved

teresaromero added 2 commits October 15, 2025 16:09

docs: update references to Podman Desktop in documentation

5c2961f

Merge branch 'main' into how-to-podman

a876cfa

teresaromero changed the title ~~Add how to develop with Podman instead of Docker~~ Add how to develop with Podman Desktop instead of Docker Oct 15, 2025

jsoriano approved these changes Oct 16, 2025

View reviewed changes

teresaromero merged commit c22a23c into elastic:main Oct 16, 2025
3 checks passed

		@@ -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.

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!

mrodm Sep 18, 2025

Choose a reason for hiding this comment

Uh oh!

teresaromero Sep 18, 2025

Choose a reason for hiding this comment

Uh oh!

mrodm Sep 19, 2025

Choose a reason for hiding this comment

Uh oh!

teresaromero Sep 19, 2025

Choose a reason for hiding this comment

Uh oh!

jsoriano Sep 19, 2025

Choose a reason for hiding this comment

Uh oh!

jsoriano Sep 19, 2025

Choose a reason for hiding this comment

Uh oh!

jsoriano Sep 19, 2025

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!

efd6 commented Oct 7, 2025

Uh oh!

jsoriano left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

elasticmachine commented Oct 15, 2025

💚 Build Succeeded

History

Uh oh!

jsoriano left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

efd6 commented Oct 16, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

teresaromero commented Sep 18, 2025 •

edited

Loading