Open WebUI

O Open WebUI é uma interface de chat prática para modelos acessíveis via API. Ele permite interagir com agentes de IA em um formato de diálogo familiar.

Este guia explica como instalar o Open WebUI e conectá-lo a um agente de IA.

O guia pressupõe que você já criou um agente de IA.

Instalação

O Open WebUI pode ser implantado localmente na sua máquina ou em um servidor remoto para acesso contínuo ao chat.

Requisitos mínimos: 2 GB de RAM.

Verifique se o Docker e o Docker Compose estão instalados:

docker --version
docker compose version

Implantação local

Para implantar o Open WebUI localmente, crie um arquivo docker-compose.yaml com o seguinte conteúdo:

services:
  openwebui:
    image: ghcr.io/open-webui/open-webui:main
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
volumes:
  open-webui:

Implantação em servidor

Se você for implantar em um servidor para facilitar o acesso, é recomendável usar um domínio e um certificado SSL. Crie um arquivo .env com as seguintes variáveis:

DOMAIN=openwebui.example.com
LETSENCRYPT_EMAIL=admin@example.com
TZ=Europe/Cyprus

• DOMAIN: domínio onde o Open WebUI estará доступível. Certifique-se de que o registro A do domínio aponta para o seu servidor.
• LETSENCRYPT_EMAIL: endereço de e-mail usado para emitir o certificado SSL.
• TZ: fuso horário do servidor.

Em seguida, crie um arquivo docker-compose.yaml com o seguinte conteúdo:

version: "3.8"

services:
  traefik:
    image: traefik:v3.1
    container_name: traefik
    restart: unless-stopped
    command:
      - "--providers.docker=true"
      - "--providers.docker.exposedbydefault=false"
      - "--entrypoints.web.address=:80"
      - "--entrypoints.websecure.address=:443"
      - "--certificatesresolvers.myresolver.acme.httpchallenge=true"
      - "--certificatesresolvers.myresolver.acme.httpchallenge.entrypoint=web"
      - "--certificatesresolvers.myresolver.acme.email=${LETSENCRYPT_EMAIL}"
      - "--certificatesresolvers.myresolver.acme.storage=/letsencrypt/acme.json"
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock:ro"
      - "letsencrypt:/letsencrypt"

  openwebui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: openwebui
    restart: unless-stopped
    environment:
      - TZ=${TZ}
      - WEBUI_URL=https://${DOMAIN}
    volumes:
      - openwebui-data:/app/backend/data
    labels:
      - "traefik.enable=true"

      # HTTPS router
      - "traefik.http.routers.openwebui.rule=Host(`${DOMAIN}`)"
      - "traefik.http.routers.openwebui.entrypoints=websecure"
      - "traefik.http.routers.openwebui.tls.certresolver=myresolver"
      - "traefik.http.services.openwebui.loadbalancer.server.port=8080"
      - "traefik.http.services.openwebui.loadbalancer.server.scheme=http"

      # HTTP router redirecting to HTTPS
      - "traefik.http.routers.openwebui-http.rule=Host(`${DOMAIN}`)"
      - "traefik.http.routers.openwebui-http.entrypoints=web"
      - "traefik.http.routers.openwebui-http.middlewares=redirect-to-https"

      # Middleware for redirecting
      - "traefik.http.middlewares.redirect-to-https.redirectscheme.scheme=https"

volumes:
  openwebui-data:
  letsencrypt:

Salve o manifesto e inicie o container:

docker compose up

O Docker fará o download da imagem e implantará o Open WebUI. Quando o logotipo aparecer no terminal, abra o navegador em http://localhost:3000/ (ou use seu domínio, se estiver em um servidor).

Se a página de boas-vindas carregar, a instalação foi concluída com sucesso.

Volte ao terminal e pare o container com Ctrl+C, depois reinicie em modo detached:

docker compose up -d

Atualize a página no navegador (http://localhost:3000/); a página de boas-vindas deve aparecer novamente.

Conectar um agente de IA

Clique em Let’s get started.

Complete a configuração da conta de administrador. Para instalações locais, você pode usar uma senha simples; para servidores, escolha uma senha forte. O e-mail informado é usado apenas como identificador ou login; nenhum e-mail será enviado para ele.

O Open WebUI suporta dois métodos para conectar agentes de IA:

• Conexão direta: cada usuário fornece sua própria chave de API e URL
• Conexão global: as configurações são definidas uma única vez no painel de administração e usadas por todos os usuários

Conexão direta

Após criar a conta de administrador, você estará na área principal. Para conectar agentes:

1. Clique no nome da conta no canto inferior esquerdo e selecione Admin Panel.
2. Vá em Settings → Connections e ative Direct Connections. Salve as alterações.
3. Para conectar um modelo clique novamente no nome da conta e vá em Settings → Connections, depois clique no ícone +.
4. Na janela, informe:
   • URL: copie do campo OpenAI URL no bloco Acesso à API no Dashboard do agente
   • Key: token de API para acesso ao agente
5. Clique em Test Connection. Se não houver erros, salve a configuração.
6. Feche a janela de configurações e clique em New Chat.

O modelo do seu agente deve aparecer no menu de seleção. Caso não apareça, atualize a página e verifique novamente.

Neste ponto, a instalação do Open WebUI e a conexão direta com o agente estão concluídas.

Conexão global (para todos os usuários)

Para configurar uma única conexão para todos os usuários:

1. Clique no nome da conta no canto inferior esquerdo e selecione Admin Panel.
2. Vá em Settings e clique no ícone + ao lado de OpenAI API.
3. Na janela, informe:
   • URL: copie do campo OpenAI URL no bloco Acesso à API no Dashboard do agente
   • Key: token de API do agente
4. Clique em Test Connection e salve se estiver tudo certo.
5. Feche a janela de configurações e clique em New Chat.

O modelo do agente deve aparecer no menu. Caso não apareça, atualize a página e verifique novamente.

Agora o Open WebUI está totalmente configurado e conectado ao seu agente de IA.