Open WebUI na VPS: sua interface de IA no navegador

Aprenda a instalar o Open WebUI no seu servidor com Docker, conectar ao Ollama ou a uma API compatível, criar o administrador, ligar o HTTPS e atualizar.

Por Redação Eleven Host · @robson.direitodigital · 1 de novembro de 2026 · 8 min de leitura

O Open WebUI na VPS é uma interface web para conversar com modelos de IA, como os do Ollama ou de APIs compatíveis com a OpenAI. Você sobe o Open WebUI em Docker no servidor e usa pelo navegador.

O que é o Open WebUI

O Open WebUI é uma tela de conversa, parecida com a de um assistente de IA, que roda no seu servidor. Ele não é o modelo de IA em si: ele se conecta a um modelo que está em outro lugar. Pode ser o Ollama, instalado na mesma VPS ou em outro servidor, ou uma API compatível com a OpenAI.

Os comandos abaixo seguem o README e a documentação do projeto, na versão v0.12.5 segundo a página de lançamentos no GitHub. Antes de instalar, vale ler também a seção de atualização.

Antes de começar

Separe estas coisas:

• Uma VPS com o Docker instalado. Se ainda está conhecendo servidores, leia antes o guia de iniciantes sobre servidor VPS.
• Um modelo para conversar. Pode ser o Ollama, ou uma chave de API compatível com a OpenAI.

Se quer ter o Ollama na própria VPS, siga primeiro o guia Ollama na VPS: como rodar IA própria no servidor. A documentação do Open WebUI não informa um requisito mínimo de memória ou processador. Quem define o peso da conversa é o modelo escolhido, e modelos maiores pedem mais do servidor. Teste com um modelo pequeno primeiro.

Os comandos docker run

O README do projeto traz um comando para cada situação. Antes, gere uma chave secreta para a sessão de login:

openssl rand -hex 32

Sem uma chave fixa, a documentação avisa que cada contêiner recriado desconecta quem estava logado. Por isso, os comandos abaixo levam a variável WEBUI_SECRET_KEY: troque your-secret-key pelo valor gerado.

Nos três comandos, a parte -v open-webui:/app/backend/data é importante: segundo o README, ela mantém o banco de dados do Open WebUI montado e evita perder dados. A interface fica na porta 3000 do servidor.

Ollama na mesma VPS

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY="your-secret-key" --name open-webui --restart always ghcr.io/open-webui/open-webui:main

O trecho --add-host deixa o contêiner alcançar o Ollama que roda no servidor. Sem a variável OLLAMA_BASE_URL, o Open WebUI procura o Ollama em http://host.docker.internal:11434.

Ollama em outro servidor

docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -e WEBUI_SECRET_KEY="your-secret-key" -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Troque https://example.com pelo endereço do seu Ollama.

Só uma API compatível com a OpenAI

docker run -d -p 3000:8080 -e OPENAI_API_KEY=your_secret_key -e WEBUI_SECRET_KEY="your-secret-key" -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Aqui, OPENAI_API_KEY recebe a chave da API que você contratou.

Nos exemplos, a imagem usa a etiqueta :main. Segundo o guia rápido do projeto, ela é uma versão contínua, em construção, e não necessariamente a última estável. Para fixar uma versão, a documentação indica o formato ghcr.io/open-webui/open-webui:vX.Y.Z.

Está escolhendo uma VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

Sobre a porta: -p 3000:8080 publica a interface em todas as interfaces de rede do servidor. Nossa sugestão é trocar por -p 127.0.0.1:3000:8080 e colocar um proxy com HTTPS na frente, como mostra a seção sobre HTTPS.

Primeiro cadastro: quem entra primeiro é o administrador

O Open WebUI não tem usuário e senha padrão. Segundo o guia rápido, a primeira conta criada é a do administrador, que gerencia os usuários e as configurações da instalação inteira. Depois que essa conta existe, o cadastro novo se desliga sozinho.

Por isso, recomendamos criar a sua conta logo depois de subir o contêiner, antes de divulgar o endereço a outras pessoas. Para outras pessoas entrarem, o administrador liga a opção New Sign Ups, e as contas novas ficam como Pending até serem aprovadas.

O guia rápido também manda ler o guia de endurecimento do projeto antes de abrir o acesso fora do seu computador. E avisa sobre o modo de usuário único (WEBUI_AUTH=False): depois de ligá-lo, não é possível voltar ao modo com várias contas.

HTTPS com um proxy reverso

Para abrir a interface em https://ia.exemplo.com (com o seu domínio), coloque um proxy reverso na frente da porta 3000 do servidor. Ele cuida do certificado e encaminha o acesso para o Open WebUI.

O guia Nginx Proxy Manager: vários sites numa VPS só mostra um painel para isso. Se preferir um servidor web com certificado automático, veja o Caddy na VPS. Nos dois casos, o domínio precisa apontar para o IP da VPS antes.

Atualizar o Open WebUI

O comando docker pull sozinho não atualiza o que já está rodando: é preciso remover o contêiner e criar de novo. Os dados ficam preservados no volume. A documentação de atualização descreve estes passos:

docker rm -f open-webui

docker pull ghcr.io/open-webui/open-webui:main

Depois, recrie o contêiner com o mesmo comando docker run que você usou na instalação, incluindo o volume e a WEBUI_SECRET_KEY. A própria documentação sugere trocar :main por uma versão fixa, se você preferir.

Há ainda o Watchtower, que atualiza contêineres automaticamente. A documentação avisa que o Watchtower original deixou de ser mantido e falha com o Docker 29 ou mais novo, e cita uma versão mantida por outra pessoa. Também alerta que atualização automática pode quebrar a instalação quando uma versão traz mudanças grandes ou migrações do banco. Para quem está começando, atualizar à mão é mais previsível.

A documentação pede backup antes de cada atualização, e com mais razão antes de versões que migram o banco, porque essas mudanças podem ser difíceis de desfazer. O comando dela para copiar o volume é:

docker run --rm -v open-webui:/data -v $(pwd):/backup alpine tar czf /backup/openwebui-$(date +%Y%m%d).tar.gz /data

Guarde o arquivo gerado fora da VPS. Segundo a documentação, o procedimento de restauração apaga o conteúdo do volume antes de extrair o backup, então leia o aviso dela antes de restaurar.

Licença: o que o projeto diz sobre a marca

O README informa que o projeto tem código sob mais de uma licença. A base atual inclui componentes sob a Open WebUI License, que traz uma exigência adicional: preservar a marca "Open WebUI". O texto da licença proíbe alterar, remover, esconder ou substituir essa marca.

A licença prevê exceções: até 50 usuários finais em um período de 30 dias corridos, permissão prévia por escrito ou uma licença enterprise que permita a alteração. Também diz que o código anterior mantém a licença original.

Isso não é interpretação jurídica. Se você pretende trocar o nome ou o logotipo, leia a licença completa no repositório e consulte um profissional.

Vale ter a interface no seu servidor

Rodar o Open WebUI você mesmo dá controle sobre onde fica a interface e qual modelo ela usa. Em troca, atualização, backup e proteção do acesso passam a ser com você.

Quer conhecer a VPS da Eleven Host? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer a VPS

Perguntas frequentes

Qual é o login padrão do Open WebUI?

Não existe login padrão. Segundo a documentação, a primeira conta criada vira a de administrador.

O Open WebUI funciona sem o Ollama?

Sim. O README traz um comando para usar só uma API compatível com a OpenAI, informando a variável OPENAI_API_KEY.

Perco meus dados ao atualizar?

Segundo a documentação, os dados no volume são preservados quando você remove e recria o contêiner. Mesmo assim, ela recomenda backup antes de cada atualização.

Para que serve a WEBUI_SECRET_KEY?

Sem uma chave fixa, cada contêiner recriado desconecta quem estava logado. Gere a chave com openssl rand -hex 32.

Posso trocar o nome e o logotipo?

A licença exige preservar a marca "Open WebUI", com exceções descritas no texto dela. Leia a licença e consulte um profissional.