~/tools / Rodar um LLM local no seu servidor / Ollama systemd Override Generator

Ollama systemd Override Generator — Crie o override do systemd do Ollama: OLLAMA_HOST, OLLAMA_MODELS, KEEP_ALIVE e mais

Crie o override do systemd que define as variáveis de ambiente do Ollama em um servidor Linux: o endereço de escuta, o diretório dos modelos, quanto tempo os modelos ficam na memória, o tamanho do contexto, as requisições em paralelo, o Flash Attention, o tipo de cache K/V, origens extras, o modo somente local e um proxy HTTPS. Todas as variáveis vêm do FAQ oficial do Ollama, e cada valor é colocado entre aspas do jeito que o systemd o lê. Nada sai do seu navegador.

Variáveis de ambiente

Campos vazios não são escritos. O texto cinza é o valor padrão informado no FAQ do Ollama.

OLLAMA_HOSTEndereço e porta em que o Ollama escutaOLLAMA_MODELSDiretório dos arquivos dos modelos; o usuário ollama precisa de acesso de leitura e escritaOLLAMA_KEEP_ALIVEQuanto tempo um modelo fica na memória: 10m, 24h, 3600 (segundos), -1 para mantê-lo, 0 para descarregá-lo na horaOLLAMA_CONTEXT_LENGTHJanela de contexto padrão, em tokensOLLAMA_NUM_PARALLELRequisições em paralelo por modelo; a memória cresce com este valor vezes o tamanho do contextoOLLAMA_MAX_LOADED_MODELSModelos carregados ao mesmo tempo, se couberem (3 para inferência em CPU)OLLAMA_MAX_QUEUERequisições na fila quando está ocupado, antes de rejeitar as demais com 503OLLAMA_FLASH_ATTENTIONUsado automaticamente quando há suporte; 1 força a ativação, 0 desativaOLLAMA_KV_CACHE_TYPEq8_0 usa cerca de metade da memória de f16 e q4_0 cerca de um quarto, com o Flash Attention ativadoOLLAMA_ORIGINSOrigens web extras autorizadas a chamar o Ollama, separadas por vírgulasOLLAMA_NO_CLOUDModo somente local, sem os modelos na nuvem nem a busca na web do OllamaDefinir OLLAMA_NO_CLOUD=1HTTPS_PROXYProxy para o download de modelos

Override para o systemctl edit

Cole no editor que o sudo systemctl edit ollama.service abre, entre as duas linhas de comentário. Ele é salvo como /etc/systemd/system/ollama.service.d/override.conf.

[Service]
Environment="OLLAMA_KEEP_ALIVE=10m"
Environment="OLLAMA_CONTEXT_LENGTH=8192"
Environment="OLLAMA_MAX_LOADED_MODELS=1"
Environment="OLLAMA_NO_CLOUD=1"

Comandos

Execute-os no servidor nesta ordem. O último mostra as variáveis que o serviço recebeu. Quando você muda OLLAMA_MODELS, os dois primeiros criam o diretório e o entregam ao usuário ollama; mkdir -p é um acréscimo nosso, porque o chown falha em um diretório que não existe.

sudo systemctl edit ollama.service
sudo systemctl daemon-reload
sudo systemctl restart ollama
systemctl show ollama --property=Environment

Variáveis e valores padrão conforme o FAQ do Ollama, e regras de aspas do manual do systemd.exec, conferidos em 2026-11-03. FAQ do Ollama / systemd.exec: Environment=

Tudo é feito no seu navegador. Nada do que você digita é enviado a lugar nenhum.

Quando o Ollama roda como serviço do systemd no Linux, o FAQ oficial diz para definir suas variáveis de ambiente com systemctl edit ollama.service: adicione uma linha Environment por variável sob [Service], salve e execute systemctl daemon-reload e systemctl restart ollama. Os passos são curtos, mas é fácil errar nos detalhes. O systemd expande especificadores, então um sinal % precisa ser escrito como %%; uma barra invertida ou aspas duplas dentro de uma atribuição entre aspas são lidas como escape; e um valor com espaço precisa ficar entre aspas por inteiro. Esta ferramenta escreve o override para você. Ela oferece apenas as variáveis documentadas no FAQ, mostra o valor padrão documentado ao lado de cada uma, coloca cada atribuição entre aspas como "NAME=value" e dobra os sinais %. Ela avisa quando um valor faria o Ollama escutar em todas as interfaces de rede, quando uma contagem não é um número inteiro e quando um cache K/V quantizado é escolhido com o Flash Attention desativado. Testamos a saída no Ubuntu 24.04 com systemd 255: colamos no systemctl edit e confirmamos que o serviço recebeu cada valor sem alteração, incluindo espaços, $, ' e %.

A lógica principal desta ferramenta é de código aberto, sob a licença MIT. github.com/seigo5555/toolkitbox-lib/src/ollama-systemd.ts

Casos de uso

Manter um modelo na memória por mais tempo, ou descarregá-lo mais cedo, em uma VPS pequena com OLLAMA_KEEP_ALIVE
Mover os arquivos dos modelos para um disco maior com OLLAMA_MODELS
Limitar o Ollama a um único modelo carregado e definir o tamanho de contexto padrão em um servidor com pouca memória

Como usar

Preencha apenas as variáveis que você quer mudar. Campos vazios são omitidos, então o Ollama mantém seus valores padrão. O texto cinza em cada campo é o valor padrão que o FAQ informa.
Leia os avisos. Um endereço de escuta diferente de 127.0.0.1 ou localhost deixa o Ollama acessível a partir de outras máquinas, e o FAQ não descreve nenhuma autenticação para isso.
Execute sudo systemctl edit ollama.service, cole o texto no editor entre as duas linhas de comentário, salve e saia. Depois execute os demais comandos para recarregar o systemd, reiniciar o Ollama e conferir os valores que ele recebeu.

FAQ

Onde o arquivo é salvo?

O systemctl edit o salva como um arquivo drop-in, /etc/systemd/system/ollama.service.d/override.conf, e deixa o arquivo de unidade principal intacto. Quando o executamos no Ubuntu 24.04, o editor mostrou o comentário ### Anything between here and the comment below will become the contents of the drop-in file. Cole o texto entre esse comentário e o que aparece abaixo dele.

Por que cada valor fica entre aspas duplas?

A documentação do systemd diz que um valor com espaços ou sinal de igual precisa ter aspas em volta de toda a atribuição. Colocar todas as linhas entre aspas do mesmo jeito preserva caminhos com espaços e listas como OLLAMA_ORIGINS. A documentação também diz que $ não tem significado especial ali, então é passado como está, enquanto % inicia um especificador, por isso a ferramenta escreve %% para um % literal.

Quais caracteres não são aceitos?

Aspas duplas, barras invertidas e caracteres de controle, como tabulações. Dentro de uma atribuição entre aspas, o systemd os lê como escapes ou os rejeita, então o valor não chegaria ao Ollama como foi digitado. A ferramenta os indica como erros e omite essa linha.

É seguro definir OLLAMA_HOST como 0.0.0.0?

Isso faz o Ollama escutar em todas as interfaces de rede, e outras máquinas podem alcançá-lo. O FAQ diz que o Ollama escuta em 127.0.0.1 porta 11434 por padrão e não descreve nenhuma autenticação para o servidor. Nossa recomendação, não uma afirmação dos documentos: mantenha o padrão e acesse o Ollama por um túnel SSH ou por um proxy com senha e HTTPS, e limite a porta 11434 no firewall.

Posso colocar uma senha em HTTPS_PROXY?

A ferramenta avisa quando o endereço do proxy contém um nome de usuário e uma senha. A documentação do systemd diz que variáveis de ambiente não são adequadas para passar segredos, porque os valores definidos para uma unidade podem ser lidos por clientes sem privilégios. O FAQ também diz para evitar definir HTTP_PROXY, porque o Ollama baixa modelos apenas por HTTPS e o HTTP_PROXY pode interromper as conexões dos clientes, por isso a ferramenta oferece apenas HTTPS_PROXY.

Algo é enviado a um servidor?

Não. O override é montado no seu navegador.

Relacionados

Ollama nginx Config Generator Local LLM Memory Estimator