search

i-am-bee / bee-stack

Run the entire bee application stack using docker-compose
Apache License 2.0
22 stars 3 forks source link

Improve getting started experience for non docker desktop users #6

Open mmurad2 opened 1 week ago

mmurad2 commented 1 week ago

Description Podman or other non-docker users face hurdles getting started with the bee-stack. Alias mapping is not enough to make the experience work well.

Desired solution Intuitive instructions adapted for each docker alternative, we can start with Podman. Open to solution alternatives.

jezekra1 commented 4 days ago

I'm not sure whether covering installation instructions for podman or others are in scope of this repository. There is nothing special needed for bee-stack (besides rootful machine which is the default).

The 2 click download and installation should work for everyone and we can't fix other problems (such as timezone shifts or freezing containers - these are podman issues)

https://podman.io/

image

If you have old non-working version on podman, you need to reinstall, that would be the same with any software. We can provide a version number.

We can set the current versions as supported in the README: Latest stable Podman 5.2.4 Latest stable Podman Desktop 1.13.3

jezekra1 commented 4 days ago

If you have any concrete examples of issues or errors with this specific version on podman, please post them here, we tried it on multiple machines, but maybe there are still some edge cases

mmurad2 commented 4 days ago

I saw multiple levels of issues around being able to run docker commands while using podman. Steps to do command mapping are not well documented on the internet. Given the change in Docker desktop license terms, we should have detailed instructions with Podman and Rancher as well.

planetf1 commented 3 days ago

I'm using podman on mac, and am able to mostly run the bee stack (other than particular issues I'm following up on).

I think it would be useful to include any tips/tricks we know of to help people get started in specific configurations. (One example PR. Much of that should point to official podman docs, but in some cases there are configuration choices. That PR, for example, refers to using docker-compose as the compose provider - without this I couldn't load one of the containers.

I've also recently come across https://github.com/i-am-bee/bee-stack/issues/13

But overall it works ... @mmurad2 are there specific issues you hit relating to Bee?

planetf1 commented 3 days ago

On docker compatibility, there are a variety of things that can be set (such as socket context, container runtime, aliasing of docker commands), but a starting point is probably using podman defaults, and making use of the podman command instead of docker