Como executar o Ollama no Podman rootless numa VPS
Aprenda a executar o Ollama no Podman rootless com utilizador dedicado, Quadlet, lingering, SELinux e API fechada na porta 11434, acessível por túnel SSH.
Executar o Ollama no Podman sem root numa VPS
Para executar o Ollama no Podman sem root num servidor, cinco condições têm de ser cumpridas, embora um guia para desktop possa ignorá-las. Um utilizador sem privilégios dedicado é proprietário do contentor. O lingering está ativado para esse utilizador, para que o contentor continue em execução depois de terminar a sessão. Um ficheiro Quadlet entrega o contentor ao systemd, para que este volte a arrancar depois de um reboot. O diretório dos modelos tem um rótulo SELinux nas distribuições que o impõem. A API escuta apenas na interface de loopback, e o acesso é feito através de um túnel SSH (secure shell).
O Ollama é um servidor para modelos de linguagem de grande dimensão (LLM). Armazena os pesos dos modelos em disco, carrega-os para a memória e responde a pedidos HTTP na porta 11434. A API local não exige início de sessão nem chave de API, por isso a rede é o único controlo de acesso disponível neste caso. O Podman executa contentores sem daemon e sem root, por isso qualquer processo que escape do contentor começa por ser executado como um utilizador normal sem privilégios. Se quiser primeiro comparar os runtimes, leia como o Podman e o Docker diferem numa VPS. Se preferir ignorar completamente os contentores, instalar o Ollama diretamente numa VPS é um caminho mais curto.
O Fedora inclui o Podman e o SELinux (security-enhanced Linux) por predefinição. Os comandos abaixo pressupõem o Podman 5 ou mais recente, e a unidade Quadlet também precisa de cgroup v2, que a documentação do Podman indica como requisito do Quadlet, independentemente da versão do Podman. Verifique ambos antes de começar: podman --version para o primeiro e podman info | grep -i cgroup para o segundo, sendo que a linha cgroupVersion tem de apresentar v2. No Ubuntu 24.04, o pacote podman do repositório está na versão 4.9.3, mais antiga do que a indicada nessa linha, por isso verifique primeiro a versão nesse sistema.
Por que a versão para laptop precisa de alterações num servidor
A Fedora Magazine publicou um guia claro sobre esta pilha em 5 August 2026: Running Ollama Locally with Podman on Fedora Linux, de Yazan Monshed. É um bom primeiro contacto de uma hora com as ferramentas. O guia também tem como alvo um laptop, e quatro das suas escolhas comportam-se de forma diferente numa máquina com um endereço IP público.
- Inicia o contentor com um `
podman run -d` simples. Um contentor iniciado manualmente não volta a arrancar depois de um reboot, porque nunca foi configurado para arrancar. - Usa a tag mutável `
ollama/ollama`. Num laptop, nota o dia em que o comportamento muda. Num servidor, o primeiro sinal é um script que deixou de funcionar durante a noite. - Faz a publicação com `
-p 11434:11434`, que associa o serviço a todas as interfaces. Atrás de um router doméstico, o serviço fica inacessível a partir da internet. Numa VPS, transforma-se numa API pública de inferência sem palavra-passe. - É executado com o seu próprio utilizador de login. Num servidor, a conta proprietária do contentor não deve ser proprietária de mais nada, para que uma fuga do contentor termine num diretório home vazio.
Nada disso está errado para a máquina a que o guia se destina. Cada item é simplesmente uma decisão que deve ser revista quando o sistema está acessível a partir de qualquer lugar e não há ninguém sentado à sua frente.
Crie o utilizador sem privilégios e verifique o subuid
O Podman sem root mapeia os IDs de utilizador (UID) internos do contentor para um bloco de IDs não utilizados no host. Esse bloco é declarado em /etc/subuid e /etc/subgid. O Podman também suporta um modo de UID único, mas configure intervalos subordinados para esta configuração.
sudo dnf install -y podman # or: sudo apt install -y podman
sudo useradd --create-home --shell /bin/bash --comment "Ollama container owner" ollama
sudo passwd --lock ollama
grep ollama /etc/subuid /etc/subgidgrep deve mostrar duas linhas, uma de cada ficheiro. Cada linha deve indicar um intervalo de 65536 IDs:
/etc/subuid:ollama:100000:65536
/etc/subgid:ollama:100000:65536O número inicial será diferente no seu sistema, o que é normal. Se grep não mostrar nada, useradd não atribuiu um intervalo. O Podman indica a ausência do mapeamento com uma mensagem semelhante a esta:
Error: cannot find UID/GID for user ollama: no subuid ranges found for user "ollama" in /etc/subuidAtribua um intervalo que não esteja associado a outro utilizador e, em seguida, informe o Podman de que o mapeamento antigo está obsoleto:
sudo usermod --add-subuids 100000-165535 --add-subgids 100000-165535 ollama
sudo -iu ollama podman system migrateBloquear a palavra-passe impede o início de sessão com palavra-passe como ollama. Isto não bloqueia outros métodos de autenticação, como chaves SSH. Aceda à conta a partir do seu utilizador de administração com sudo -iu ollama.
Ative o lingering para que o serviço sobreviva ao logout
A instância systemd de um utilizador normalmente inicia no login e para depois do último logout, e /run/user/<uid> é removido com ela. Os serviços geridos por essa instância param quando ela para. O lingering mantém a instância do utilizador em execução sem uma sessão associada.
sudo loginctl enable-linger ollama
loginctl show-user ollama --property=LingerIsso deve apresentar Linger=yes. Ative-o antes de criar a unit, para que o gestor do utilizador e o respetivo diretório de runtime estejam disponíveis sem uma sessão de login.
Existe mais um passo que normalmente não é esperado. sudo -iu ollama fornece uma shell, mas não um barramento de sessão; por isso, systemctl --user falha imediatamente:
Failed to connect to bus: $DBUS_SESSION_BUS_ADDRESS and $XDG_RUNTIME_DIR not definedO systemd procura o barramento do utilizador em $XDG_RUNTIME_DIR/bus, e sudo -i não define essa variável. Defina-a manualmente em cada shell de administração onde gerir este serviço:
sudo -iu ollama
export XDG_RUNTIME_DIR=/run/user/$(id -u)
systemctl --user statusOnde os blobs dos modelos ficam e quanto espaço em disco planear
O Ollama grava os pesos em /root/.ollama/models dentro do contentor. Associe um diretório do diretório pessoal do utilizador a esse caminho, para que os ficheiros fiquem num local que possa medir: /home/ollama/ollama-data/models. Os blobs ficam em models/blobs como ficheiros endereçados pelo conteúdo, e models/manifests contém o pequeno índice que lhes atribui nomes. Se utilizar um volume nomeado, como no artigo da Fedora Magazine, a mesma árvore fica em /home/ollama/.local/share/containers/storage/volumes/<volume>/_data. Em ambos os casos, ollama pull e ollama run gravam os pesos na mesma árvore. O que separa os dois comandos é apenas o facto de uma sessão de chat ser aberta depois de a transferência terminar.
Dimensione o disco antes de transferir qualquer coisa. Os tamanhos de transferência publicados indicam o mínimo necessário.
Os dados por trás deste gráfico
[
{
"label": "gemma3:4b",
"download_gb": 3.4
},
{
"label": "mistral:7b",
"download_gb": 4.4
},
{
"label": "qwen3:8b",
"download_gb": 5.2
},
{
"label": "gemma3:12b",
"download_gb": 8.2
},
{
"label": "qwen3:14b",
"download_gb": 9.3
},
{
"label": "gemma3:27b",
"download_gb": 17
},
{
"label": "qwen3:30b",
"download_gb": 19
}
]Todas as 7 linhas são valores publicados em ollama.com/library, não tamanhos medidos num disco. A tag mais pequena, gemma3:4b, transfere 3.4 GB. A maior, qwen3:30b, transfere 19 GB. A imagem do contentor ocupa espaço adicional no armazenamento do próprio Podman. Por isso, verifique os dois valores em conjunto com podman system df e df -h /home. Para obter um bom desempenho, reserve aproximadamente o tamanho do ficheiro do modelo em RAM, além de espaço para a janela de contexto. A RAM física não é um limite absoluto: o mapeamento de memória apoiado em disco ou uma quantidade suficiente de swap pode permitir executar um modelo de 19 GB numa VPS com 16 GB, com desempenho reduzido.
Fixe a tag da imagem e use o nome completo do registry
sudo -iu ollama
export XDG_RUNTIME_DIR=/run/user/$(id -u)
mkdir -p ~/ollama-data ~/.config/containers/systemd
podman pull docker.io/ollama/ollama:0.32.9Use uma tag de versão lançada, 0.32.9 em agosto de 2026, e não latest. Desde então foram lançadas versões mais recentes: em 30 de outubro de 2026, a tag de versão simples mais recente no Docker Hub é 0.40.13. Consulte a página de tags e use a versão atual tanto no comando pull como na linha Image=. Uma tag de versão fixa impede que versões que não escolheu sejam instaladas no servidor. Assim, uma alteração de comportamento normalmente resulta de uma alteração feita por si. No entanto, uma tag continua a ser um ponteiro, não uma impressão digital: o registry pode apontá-la para outra imagem quando alguém publica novamente com o mesmo nome. Apenas um digest é imutável. O Podman aceita ambas as formas em Image=. Se um reinício às 04:00 tiver de executar exatamente o binário que testou, execute podman images --digests docker.io/ollama/ollama depois do pull e escreva Image=docker.io/ollama/ollama@sha256:<digest> em vez disso. O Docker Hub também publica as tags -rc e -rocm para as mesmas versões. Escolha a tag simples, a menos que tenha uma GPU AMD.
Escreva também o host do registry. No Fedora, um nome curto numa unidade systemd não tem um terminal onde possa pedir confirmação, e a unidade falha com:
Error: short-name "ollama/ollama" did not resolve to an alias and no unqualified-search registries are definedFazer primeiro o pull manualmente é opcional, mas útil, porque retira o download de vários gigabytes do tempo limite de arranque da unidade.
A unidade Quadlet que sobrevive a um reboot
O Quadlet é o gerador systemd do Podman. Escreva um ficheiro .container, o systemd transforma-o num serviço no arranque e podman generate systemd deixa de ser necessário. Guarde-o como /home/ollama/.config/containers/systemd/ollama.container, pertencente ao utilizador ollama.
[Unit]
Description=Ollama API (rootless)
After=network-online.target
Wants=network-online.target
[Container]
Image=docker.io/ollama/ollama:0.32.9
ContainerName=ollama
PublishPort=127.0.0.1:11434:11434
Volume=/home/ollama/ollama-data:/root/.ollama:Z
Environment=OLLAMA_KEEP_ALIVE=30m
Environment=OLLAMA_MAX_LOADED_MODELS=1
[Service]
Restart=always
TimeoutStartSec=900
[Install]
WantedBy=default.targetO nome do ficheiro define o nome do serviço, por isso ollama.container passa a ser ollama.service.
systemctl --user daemon-reload
systemctl --user start ollama.service
systemctl --user status ollama.servicestatus deve mostrar active (running). Não execute systemctl --user enable ollama.service. A unidade não existe como ficheiro no disco, por isso o systemd recusa:
Failed to enable unit: Unit file /run/user/1001/systemd/generator/ollama.service is transient or generated.A secção [Install] já executa essa função. O Quadlet cria automaticamente a ligação de arranque durante daemon-reload, razão pela qual esse comando é obrigatório. TimeoutStartSec=900 cobre um primeiro arranque que ainda precisa de transferir a imagem, porque os 90 segundos predefinidos não são suficientes para uma transferência de vários gigabytes e o systemd termina o arranque com falha. OLLAMA_KEEP_ALIVE=30m mantém um modelo na memória entre pedidos, em vez de o descarregar ao fim de cinco minutos; os compromissos dessa opção estão explicados em manter um modelo Ollama carregado na memória. Se algum dos termos do systemd usados aqui for novo, como funcionam os serviços e temporizadores do systemd numa VPS explica as próprias unidades.
Por que o diretório de modelos retorna "permission denied" com o SELinux
No Fedora, RHEL, Rocky e AlmaLinux, o SELinux é aplicado por padrão. Um processo de contentor é executado no domínio container_t, e um diretório na home de um utilizador recebe a etiqueta user_home_t. A política não permite que um interaja com o outro. Por isso, o Ollama não consegue criar a sua árvore de modelos e o contentor termina. Nestes sistemas, getenforce apresenta Enforcing, e a negação é registada:
sudo ausearch -m avc -ts recentVerá uma linha que identifica o domínio e a etiqueta do destino:
avc: denied { write } for pid=1842 comm="ollama" name="models" dev="vda1" ino=131077 scontext=system_u:system_r:container_t:s0:c214,c827 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=dir permlisted=0O :Z no fim da linha Volume= é a correção. Ele volta a etiquetar o diretório do host como container_file_t e atribui-lhe uma categoria MCS privada (multi-category security) que apenas este contentor possui. O :z em minúsculas usa uma etiqueta partilhada. É essa a opção correta quando dois contentores leem o mesmo diretório.
Tenha atenção ao :Z, porque esta operação é destrutiva e silenciosa. A etiquetagem é recursiva. Se a apontar para /home/ollama, todos os ficheiros desse diretório home serão novamente etiquetados, o que impede o acesso às chaves SSH desse utilizador. Atribua sempre a :Z um subdiretório dedicado que não contenha mais nada. Os volumes nomeados não precisam disso, porque o Podman atribui-lhes as etiquetas corretas quando os cria. Para obter uma visão mais ampla, noções básicas do SELinux para um servidor explica os contextos e os booleanos. No Ubuntu e no Debian, é utilizado o AppArmor. Nesse caso, :Z não faz nada, e deixá-lo na unidade não causa problemas.
Feche a porta 11434 e aceda à API por SSH
PublishPort=127.0.0.1:11434:11434 associa o lado do host ao loopback. Confirme:
ss -ltnp | grep 11434
curl http://127.0.0.1:11434A saída de ss deve mostrar 127.0.0.1:11434, e curl deve responder com Ollama is running. Se ss mostrar 0.0.0.0:11434 ou *:11434, a porta está a escutar em todas as interfaces. Se a Internet consegue alcançá-la depende das regras da firewall e da rede à frente do servidor. Portanto, um listener curinga não fica automaticamente exposto. Ainda assim, não dependa disso: a documentação do Ubuntu indica que ufw vem inicialmente desativado por predefinição, e uma regra da firewall é mais um elemento que tem de permanecer correto. Corrija o endereço de associação para que a porta nunca fique publicamente à escuta.
Seja preciso sobre o lado ao qual está a associar o endereço. O endereço em PublishPort é o endereço do host. Dentro do contentor, o Ollama deve continuar a escutar em todas as interfaces, que é a predefinição da imagem. Definir Environment=OLLAMA_HOST=127.0.0.1 associa o Ollama ao loopback do próprio contentor, e o Podman encaminha o tráfego publicado para o endereço de rede do contentor. Por isso, todos os pedidos são recusados, mesmo a partir do host.
Uma porta 11434 aberta cria dois riscos. O Ollama não tem autenticação. Qualquer pessoa que alcance a porta pode listar os seus modelos através de /api/tags, executar inferência no seu CPU e consumir a sua quota de largura de banda através de /api/generate, transferir novos modelos para o disco e eliminar os modelos existentes. Em segundo lugar, o HTTP simples para uma porta remota envia os prompts e as respostas em texto não cifrado. Todas as máquinas no caminho podem lê-los. Ambos os problemas desaparecem se a porta nunca sair do servidor.
A partir da sua estação de trabalho, encaminhe a porta por SSH:
ssh -N -L 11434:127.0.0.1:11434 you@vps.example.comAgora http://127.0.0.1:11434 no seu portátil é o Ollama do servidor, dentro da encriptação da sessão SSH. Se o seu portátil já executar o Ollama, a associação local falha com bind [127.0.0.1]:11434: Address already in use. Use -L 11435:127.0.0.1:11434 e aponte o cliente para 11435.
Quando um cliente de browser precisar de acesso, coloque antes dele um reverse proxy com palavra-passe. Um bloco de site do Caddy é curto, e caddy hash-password imprime o hash bcrypt necessário:
ollama.example.com {
basic_auth {
you $2a$14$replace_with_the_generated_hash
}
reverse_proxy 127.0.0.1:11434
}O Caddy obtém automaticamente um certificado através de TLS (transport layer security), pelo que o tráfego fica cifrado. Teste primeiro o cliente: os clientes que não conseguem enviar um cabeçalho Authorization falham com a autenticação básica e um 401 Unauthorized simples. O túnel SSH não tem esse problema, razão pela qual é a recomendação predefinida neste caso.
Baixe um modelo e verifique todo o caminho
podman exec -it ollama ollama pull gemma3:4b
curl -s http://127.0.0.1:11434/api/tags
curl -s http://127.0.0.1:11434/api/generate -d '{"model":"gemma3:4b","prompt":"Reply with the single word: ready","stream":false}'
du -sh ~/ollama-data/models/api/tags retorna uma lista JSON com gemma3:4b. /api/generate retorna um objeto JSON com um campo response, depois de uma pausa enquanto os pesos são carregados do disco. du deve apresentar um número próximo do tamanho de download publicado. Em seguida, confirme a parte central de todo este guia:
sudo reboot
# reconnect, then:
sudo -iu ollama
export XDG_RUNTIME_DIR=/run/user/$(id -u)
systemctl --user is-active ollama.serviceactive significa que a persistência está funcionando, que a seção [Install] e daemon-reload executaram as respetivas tarefas. Se retornar inactive, verifique primeiro esses três pontos e depois consulte journalctl --user -u ollama.service em busca de erros na inicialização.
Modos de falha e mensagens que verá
O contentor desaparece depois de um reboot. Verifique primeiro loginctl show-user ollama --property=Linger, porque, sem Linger=yes, a instância systemd do utilizador nunca arranca no boot. Se o lingering estiver ativo, verifique a secção [Install] no ficheiro .container, execute systemctl --user daemon-reload e consulte journalctl --user -u ollama.service à procura de erros de arranque.
Error: statfs /home/ollama/ollama-data: no such file or directory. A origem do bind mount tem de existir antes de o contentor arrancar. O Podman não cria diretórios no host automaticamente. Execute mkdir -p ~/ollama-data como o utilizador ollama.
O arranque falha aos 90 segundos. journalctl --user -u ollama.service mostra Start operation timed out. Terminating. porque a obtenção da imagem ainda estava em execução. Faça o pull manualmente ou mantenha TimeoutStartSec=900.
O contentor arranca e termina. podman logs ollama e sudo ausearch -m avc -ts recent, em conjunto, indicam se o problema está na etiqueta SELinux. Um AVC que mencione container_t e user_home_t significa que falta :Z.
Os pedidos provenientes do host são recusados. curl: (7) Failed to connect to 127.0.0.1 port 11434: Connection refused com o serviço active normalmente significa que OLLAMA_HOST foi definido como um endereço de loopback dentro do contentor. Remova essa linha.
A geração é muito lenta ou o contentor é terminado. Sem GPU, a inferência é executada no CPU e um modelo grande é naturalmente lento. O mapeamento de memória suportado por disco ou o swap tornam a inferência mais lenta quando o modelo não cabe na RAM física. Um contentor que termine durante um pedido e apresente signal: killed nos logs precisa de uma análise da causa; se o log do kernel confirmar um encerramento por falta de memória, escolha uma tag mais pequena no quadro acima.
Atualizar uma imagem fixada
Fixar uma imagem significa que as atualizações são uma ação controlada, não uma alteração inesperada. Edite Image= em ollama.container e, em seguida, recarregue e reinicie:
systemctl --user daemon-reload
systemctl --user restart ollama.service
podman exec ollama ollama --versionOs modelos ficam no bind mount, por isso permanecem intactos quando a imagem muda. AutoUpdate=registry na secção [Container] configura verificações do digest no registry; podman auto-update, executado manualmente ou pelo respetivo temporizador do systemd, obtém uma imagem alterada e reinicia a unidade. Isto é adequado para uma tag que muda. Ao lado de uma tag de versão, é acionado apenas quando o publicador envia novamente essa mesma tag. Essa é precisamente a alteração não planeada que a fixação deve impedir, por isso deixe-o desativado aqui. Faça uma cópia de segurança de /home/ollama/ollama-data/models/manifests e do ficheiro .container e ignore os blobs: são grandes, e ollama pull obtém-nos novamente num servidor novo.
FAQ
Por que o meu contentor Podman rootless para quando termino a sessão?
A instância systemd de um utilizador e o seu diretório /run/user/<uid> são normalmente desmontados depois de terminar a última sessão desse utilizador. Isto para os serviços geridos por essa instância. Execute sudo loginctl enable-linger ollama e confirme que loginctl show-user ollama --property=Linger apresenta Linger=yes. Ative o lingering antes de criar a unidade Quadlet, para que o gestor de utilizadores e o respetivo diretório de runtime estejam disponíveis sem uma sessão iniciada.
Preciso de etiquetas SELinux no diretório dos modelos do Ollama?
No Fedora, RHEL, Rocky e AlmaLinux, sim, se montar um diretório do host através de bind mount. O contentor é executado no domínio container_t e um diretório numa pasta pessoal tem a etiqueta user_home_t. Por isso, a escrita é negada e o Ollama termina. Acrescente :Z à linha Volume= e atribua-lhe um subdiretório dedicado, porque a reetiquetagem é recursiva e apontar :Z para uma pasta pessoal inteira impede o acesso às chaves SSH desse utilizador. Os volumes nomeados recebem as etiquetas corretas pelo Podman e não precisam de configuração adicional.
Quanto espaço em disco precisa um modelo do Ollama?
Comece pelo tamanho de transferência publicado em ollama.com/library, que varia entre 3.4 GB para gemma3:4b e 19 GB para qwen3:30b. Some a imagem Podman e deixe espaço adicional, porque um segundo modelo não substitui o primeiro no disco. Verifique df -h /home antes de fazer o pull e du -sh ~/ollama-data/models depois. Para obter um bom desempenho, reserve aproximadamente o tamanho do ficheiro do modelo em RAM, além de espaço para a janela de contexto. O mapeamento de memória suportado pelo disco ou uma quantidade suficiente de swap pode permitir executar um modelo maior com menos RAM física, mas com desempenho inferior.
É seguro expor a porta 11434 numa VPS?
Não. O Ollama é distribuído sem qualquer autenticação, por isso qualquer pessoa que alcance a porta pode listar os seus modelos, eliminá-los, fazer pull de novos modelos para o disco e executar inferência no CPU e no limite de largura de banda. O HTTP simples através da internet também envia cada prompt e cada resposta em texto simples. Faça o bind do lado do host a 127.0.0.1 com PublishPort=127.0.0.1:11434:11434, confirme com ss -ltnp | grep 11434 e aceda através de um túnel SSH ou de um reverse proxy que exija uma palavra-passe.