Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore(docs): Info on using local resources/troubleshooting podman macos #11

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

planetf1
Copy link
Contributor

@planetf1 planetf1 commented Oct 29, 2024

Two suggestions for readme as a followon to PR #10

  • Adds section on accessing local resources on the container host

I've added links to the reference docs, and given an example of hostnames that work in the default case. However there are many potential combinations...

I've also added an explicit config example - this depends on the earlier PR being an acceptable fix.

  • Added troubleshooting section

I hit issues with podman-compose, and added workaround to the readme. One other option is to consider removal of the ulimit spec in compose, but at least by adding a doc note that could be considered separately


The hostnames are:
* host.containers.internal (podman)
* host.docker.internal (docker)
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As author I'll add a note that it seems recent versions of podman do also support the docker host ( containers/podman#19361 )but I've left the text as-is for now

@planetf1 planetf1 requested a review from a team as a code owner November 4, 2024 12:55
@planetf1
Copy link
Contributor Author

planetf1 commented Nov 4, 2024

Squashed, rebased, & made consistent with fix in #10

@Tomas2D
Copy link
Contributor

Tomas2D commented Dec 6, 2024

ping @jezekra1

If you are a developer on `bee-api` or `bee-ui` and want to run only the supporting infrastructure,
use the profile `infra`, e.g.:

```shell
docker compose --profile infra up -d
```
### Connecting to host resources
Copy link
Collaborator

@jezekra1 jezekra1 Dec 6, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please move this to troubleshooting guide

The generic comments are not necessary we only need to access host for ollama, the guide is organized by error messages, please add it under the specific error message which occurs when you cannot connect to ollama.

You can also improve the error message in ./bee-stack.sh directly


Below is an example `.env` configuration for a podman environment which will allow the bee stack to connect back to ollama running on the host
```
LLM_BACKEND=ollama
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please remove this section, this is already in example.env and it's configured automatically with the ./bee-stack.sh script

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants