Files
open-webui-docs/docs/getting-started/quick-start/tab-docker/Podman.md
2025-03-27 14:27:57 -04:00

1.2 KiB

Using Podman

Podman is a daemonless container engine for developing, managing, and running OCI Containers.

Basic Commands

  • Run a Container:

    podman run -d --name openwebui -p 3000:8080 -v open-webui:/app/backend/data ghcr.io/open-webui/open-webui:main
    
  • List Running Containers:

    podman ps
    

Networking with Podman

If networking issues arise, use slirp4netns to adjust the pod's network settings to allow the container to access your computer's ports.

Ensure you have slirp4netns installed, remove the previous container if it exists using podman rm, and start a new container with

  podman run -d --network=slirp4netns:allow_host_loopback=true --name openwebui -p 3000:8080 -v open-webui:/app/backend/data ghcr.io/open-webui/open-webui:main

If you are using Ollama from your computer (not running inside a container),

Once inside open-webui, navigate to Settings > Admin Settings > Connections and create a new Ollama API connection to http://10.0.2.2:[OLLAMA PORT]. By default, the Ollama port is 11434.

Refer to the Podman documentation for advanced configurations.