Open WebUI

Implante Open WebUI e gerencie a conexão como administrador.

Instalação e preparação

Instale Docker e siga o início rápido do Open WebUI ou execute o comando abaixo. Preserve o volume de dados para manter contas e configurações. Abra http://localhost:3000 e crie a primeira conta de administrador. Crie a chave em routerra.ai Keys e obtenha um ID permitido na lista do gateway.

Configurar a conexão

Como administrador, abra Settings → Admin → Connections → Manage OpenAI API Connections → Add Connection. URL: https://routerra.ai/v1; API Key: YOUR_API_KEY. Ative e salve o tipo compatível com OpenAI padrão. Os modelos normalmente vêm de /models; caso contrário, adicione YOUR_MODEL_ID à lista permitida Model IDs. Esta conexão de servidor é compartilhada conforme as permissões da instância, diferente das Direct Connections pessoais do navegador.

docker run -d --name open-webui -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --restart always ghcr.io/open-webui/open-webui:main

Selecionar um modelo e resolver erros

Selecione YOUR_MODEL_ID em um novo chat. Se faltar, confira ativação e lista permitida e salve para atualizar. Valores no banco podem substituir OPENAI_API_BASE_URL e OPENAI_API_KEY ao reiniciar: edite a conexão Admin. ENABLE_PERSISTENT_CONFIG=False força o ambiente, mas alterações Admin não persistem. Para erros de rede, consulte docker logs open-webui e verifique o HTTPS de saída do contêiner.