~/tools / Ejecutar un LLM local en tu servidor / Ollama systemd Override Generator

Ollama systemd Override Generator — Crea el override de systemd de Ollama: OLLAMA_HOST, OLLAMA_MODELS, KEEP_ALIVE y más

Crea el override de systemd que define las variables de entorno de Ollama en un servidor Linux: la dirección de escucha, el directorio de modelos, cuánto tiempo permanecen los modelos en memoria, la longitud de contexto, las peticiones en paralelo, Flash Attention, el tipo de caché K/V, orígenes adicionales, el modo solo local y un proxy HTTPS. Todas las variables proceden de las preguntas frecuentes oficiales de Ollama, y cada valor se entrecomilla tal como lo lee systemd. Nada sale de tu navegador.

Variables de entorno

Los campos vacíos no se escriben. El texto gris es el valor por defecto que indican las preguntas frecuentes de Ollama.

OLLAMA_HOSTDirección y puerto en los que escucha OllamaOLLAMA_MODELSDirectorio de los archivos de modelos; el usuario ollama necesita acceso de lectura y escrituraOLLAMA_KEEP_ALIVECuánto tiempo permanece un modelo en memoria: 10m, 24h, 3600 (segundos), -1 para mantenerlo, 0 para descargarlo al instanteOLLAMA_CONTEXT_LENGTHVentana de contexto por defecto, en tokensOLLAMA_NUM_PARALLELPeticiones en paralelo por modelo; la memoria crece con este valor multiplicado por la longitud de contextoOLLAMA_MAX_LOADED_MODELSModelos cargados a la vez si caben (3 para inferencia en CPU)OLLAMA_MAX_QUEUEPeticiones en cola cuando hay carga antes de rechazar más con 503OLLAMA_FLASH_ATTENTIONSe usa automáticamente si es compatible; 1 lo fuerza, 0 lo desactivaOLLAMA_KV_CACHE_TYPEq8_0 usa cerca de la mitad de memoria que f16 y q4_0 cerca de la cuarta parte, con Flash Attention activadoOLLAMA_ORIGINSOrígenes web adicionales que pueden llamar a Ollama, separados por comasOLLAMA_NO_CLOUDModo solo local, sin los modelos en la nube ni la búsqueda web de OllamaDefinir OLLAMA_NO_CLOUD=1HTTPS_PROXYProxy para la descarga de modelos

Override para systemctl edit

Pégalo en el editor que abre sudo systemctl edit ollama.service, entre las dos líneas de comentario. Se guarda 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

Ejecútalos en el servidor en este orden. El último muestra las variables que ha recibido el servicio. Cuando cambias OLLAMA_MODELS, los dos primeros crean el directorio y se lo asignan al usuario ollama; mkdir -p es un añadido nuestro, porque chown falla en un directorio que no existe.

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

Variables y valores por defecto según las preguntas frecuentes de Ollama, y reglas de entrecomillado del manual de systemd.exec, comprobados el 2026-11-03. Preguntas frecuentes de Ollama / systemd.exec: Environment=

Todo se hace en tu navegador. Nada de lo que introduces se envía a ningún sitio.

Cuando Ollama se ejecuta como servicio de systemd en Linux, las preguntas frecuentes oficiales indican que sus variables de entorno se definen con systemctl edit ollama.service: añade una línea Environment por variable bajo [Service], guarda y ejecuta systemctl daemon-reload y systemctl restart ollama. Los pasos son pocos, pero es fácil equivocarse en los detalles. systemd expande los especificadores, así que un signo % debe escribirse como %%; una barra invertida o unas comillas dobles dentro de una asignación entrecomillada se leen como un escape; y un valor con espacios debe entrecomillarse entero. Esta herramienta escribe el override por ti. Ofrece solo las variables documentadas en las preguntas frecuentes, muestra junto a cada una su valor por defecto documentado, entrecomilla cada asignación como "NAME=value" y duplica los signos %. Avisa cuando un valor haría que Ollama escuchara en todas las interfaces de red, cuando un número no es entero y cuando se elige una caché K/V cuantizada con Flash Attention desactivado. Probamos la salida en Ubuntu 24.04 con systemd 255: la pegamos en systemctl edit y comprobamos que el servicio recibía cada valor sin cambios, incluidos espacios, $, ' y %.

La lógica principal de esta herramienta es de código abierto, con licencia MIT. github.com/seigo5555/toolkitbox-lib/src/ollama-systemd.ts

Casos de uso

Mantener un modelo en memoria más tiempo, o descargarlo antes, en un VPS pequeño con OLLAMA_KEEP_ALIVE
Mover los archivos de modelos a un disco más grande con OLLAMA_MODELS
Limitar Ollama a un solo modelo cargado y fijar la longitud de contexto por defecto en un servidor con poca memoria

Cómo usarlo

Rellena solo las variables que quieras cambiar. Los campos vacíos se omiten, así que Ollama conserva sus valores por defecto. El texto gris de cada campo es el valor por defecto que indican las preguntas frecuentes.
Lee los avisos. Una dirección de escucha distinta de 127.0.0.1 o localhost hace que Ollama sea accesible desde otras máquinas, y las preguntas frecuentes no describen ninguna autenticación para ello.
Ejecuta sudo systemctl edit ollama.service, pega el texto en el editor entre las dos líneas de comentario, guarda y sal. Después ejecuta el resto de los comandos para recargar systemd, reiniciar Ollama y comprobar los valores que ha recibido.

FAQ

¿Dónde se guarda el archivo?

systemctl edit lo guarda como archivo drop-in, /etc/systemd/system/ollama.service.d/override.conf, y deja intacto el archivo de unidad principal. Cuando lo ejecutamos en Ubuntu 24.04, el editor mostró el comentario ### Anything between here and the comment below will become the contents of the drop-in file. Pega el texto entre ese comentario y el que aparece más abajo.

¿Por qué cada valor va entre comillas dobles?

La documentación de systemd dice que un valor que contenga espacios o un signo igual debe llevar comillas alrededor de toda la asignación. Entrecomillar todas las líneas de la misma manera conserva intactas las rutas con espacios y listas como OLLAMA_ORIGINS. La documentación dice también que $ no tiene aquí ningún significado especial, así que se pasa tal cual, mientras que % inicia un especificador, por lo que la herramienta escribe %% para un % literal.

¿Qué caracteres no se aceptan?

Las comillas dobles, las barras invertidas y los caracteres de control, como los tabuladores. Dentro de una asignación entrecomillada, systemd los lee como escapes o los rechaza, así que el valor no llegaría a Ollama tal como lo escribiste. La herramienta los señala como errores y omite esa línea.

¿Es seguro poner OLLAMA_HOST en 0.0.0.0?

Hace que Ollama escuche en todas las interfaces de red, de modo que otras máquinas pueden alcanzarlo. Las preguntas frecuentes dicen que Ollama se enlaza por defecto a 127.0.0.1 puerto 11434 y no describen ninguna autenticación para el servidor. Nuestra recomendación, no una afirmación de los documentos: mantén el valor por defecto y accede a Ollama mediante un túnel SSH o un proxy con contraseña y HTTPS, y limita el puerto 11434 en el cortafuegos.

¿Puedo poner una contraseña en HTTPS_PROXY?

La herramienta avisa cuando la dirección del proxy contiene un nombre de usuario y una contraseña. La documentación de systemd dice que las variables de entorno no son adecuadas para pasar secretos, porque los valores definidos para una unidad pueden ser leídos por clientes sin privilegios. Las preguntas frecuentes dicen también que se evite definir HTTP_PROXY, porque Ollama descarga modelos solo por HTTPS y HTTP_PROXY puede interrumpir las conexiones de los clientes, por lo que la herramienta ofrece solo HTTPS_PROXY.

¿Se envía algo a un servidor?

No. El override se compone en tu navegador.

Relacionados

Ollama nginx Config Generator Local LLM Memory Estimator