systemctl es la herramienta de systemd para controlar servicios en Linux. Por SSH se usa igual que en una consola local. systemctl status muestra el estado y los últimos logs, y restart reinicia. enable --now arranca y activa en el arranque, daemon-reload recarga units editadas e is-active devuelve un estado apto para scripts.

Comandos básicos de systemctl para gestionar un servicio por SSH

sudo systemctl start nginx arranca el servicio y sudo systemctl stop nginx lo detiene. Las consultas como status, is-active o is-enabled funcionan sin sudo, aunque sin privilegios puede que no veas las líneas de log. Estas órdenes cubren casi todo el trabajo diario con una unit:

systemctl status nginx
sudo systemctl start nginx
sudo systemctl stop nginx
sudo systemctl restart nginx
sudo systemctl reload nginx
sudo systemctl enable --now nginx
sudo systemctl disable --now nginx
sudo systemctl daemon-reload
systemctl is-active nginx
systemctl is-enabled nginx
systemctl list-units --type=service --state=failed

El nombre de la unit puede escribirse sin el sufijo .service. Con el propio servidor SSH hay que fijarse en el nombre: en Debian y Ubuntu la unit suele llamarse ssh y en otras distribuciones sshd. La referencia completa de subcomandos y opciones está en la página de manual de systemctl.

systemctl status: cómo leer el estado de un servicio remoto

systemctl status nginx resume en pocas líneas lo necesario para diagnosticar un servicio:

  • Loaded: ruta del archivo de la unit y si está enabled o disabled para el arranque.
  • Active: active (running), inactive (dead) o failed, con la hora del último cambio.
  • Main PID y el árbol de procesos: qué procesos pertenecen al servicio.
  • Últimas líneas del journal: el error suele estar aquí cuando el servicio no arranca.

Si la salida no cabe en pantalla, status abre un paginador que se cierra con q. La opción --no-pager lo evita y -l (o --full) muestra las líneas sin recortar. Cuando esas líneas no bastan, journalctl -u nginx -n 50 --no-pager da más contexto. journalctl -u nginx -f sigue el log en directo hasta que pulsas Ctrl+C. Los filtros por fecha y prioridad están en el manual de journalctl.

systemctl restart, reload y enable --now: cuándo usar cada uno

  1. restart detiene el servicio y lo vuelve a arrancar, cortando las conexiones que gestione el proceso.
  2. reload pide al servicio que relea su configuración sin pararse. Solo funciona si la unit define cómo hacerlo; si no, devuelve error.
  3. reload-or-restart recarga cuando la unit lo permite y reinicia cuando no.
  4. enable --now activa el servicio para el arranque del sistema y además lo arranca en ese momento. enable a secas no arranca nada hasta el próximo arranque.
  5. disable --now hace lo contrario: lo quita del arranque y lo detiene.

Antes de reiniciar el servidor SSH por el que estás conectado, valida su configuración con sudo sshd -t. Si hay un error de sintaxis, lo muestra y sale con un código distinto de cero. Mantén una segunda sesión abierta hasta comprobar que puedes volver a entrar por el puerto TCP 22 o por el que uses.

systemctl daemon-reload tras editar un archivo .service

sudo systemctl daemon-reload hace que systemd vuelva a leer los archivos de units. Sin él, los cambios en un .service no se aplican, y status avisa de que la unit ha cambiado en disco. La secuencia habitual es esta:

sudo nano /etc/systemd/system/miapp.service
sudo systemctl daemon-reload
sudo systemctl restart miapp
systemctl status miapp --no-pager -l

daemon-reload no reinicia ningún servicio: solo recarga la configuración del gestor. Es el restart posterior el que hace que el proceso use la nueva definición.

systemctl is-active en scripts y comprobaciones rápidas

systemctl is-active imprime el estado de la unit (active, inactive, failed…) y sale con código 0 solo si está activa. Por eso sirve directamente en condicionales. Con --quiet no imprime nada y solo cuenta el código de salida:

systemctl is-active --quiet nginx && echo 'nginx OK' || sudo systemctl restart nginx
systemctl is-failed --quiet miapp && journalctl -u miapp -n 20 --no-pager

is-enabled sigue la misma lógica para el arranque del sistema. is-failed detecta las units que han caído, que también aparecen con systemctl list-units --type=service --state=failed.

systemctl desde el móvil frente al escritorio: qué cambia

systemctl se comporta igual en cualquier cliente SSH. Lo que cambia en el móvil es el acceso a las teclas y la estabilidad de la conexión:

Tarea con systemctlMóvil (iOS/Android)Escritorio
Salir del paginador o de journalctl -fNecesita Ctrl y Esc, que el teclado del sistema escondeCtrl y Esc siempre en el teclado físico
Recorrer logs largosPgUp/PgDn solo si el cliente las ofreceTeclas PgUp/PgDn físicas
Conexión durante un reinicio largoPasar de wifi a datos corta SSH; Mosh mantiene la sesiónRed normalmente estable
Editar un archivo .serviceEditor en terminal o SFTP para bajar y subirEditor local o remoto

En termi1, una terminal SSH y Mosh móvil, el teclado propio añade Esc, Ctrl, Tab, flechas y un plano fn con PgUp/PgDn, Inicio y Fin. Mosh mantiene la sesión al pasar de wifi a datos y tmux conserva lo que dejas corriendo. El SFTP integrado permite revisar un .service sin salir de la sesión. La IA escribe el comando en el prompt sin pulsar Intro, y en el modo «Revisar» nunca lo ejecuta. En conexiones etiquetadas como producción, Production Guard impide que nada reciba Intro automáticamente. Además, retiene antes de llegar al prompt lo que detiene o cambia algo, como systemctl stop. Está disponible como termi1 en la App Store y en Google Play.

Preguntas frecuentes

¿Qué diferencia hay entre systemctl restart y systemctl reload?

systemctl restart detiene el servicio y lo arranca de nuevo, cortando las conexiones que gestiona el proceso. systemctl reload solo pide al servicio que relea su configuración sin pararse. Únicamente funciona si la unit define una acción de recarga; reload-or-restart elige automáticamente.

¿Cuándo hay que ejecutar systemctl daemon-reload?

systemctl daemon-reload hay que ejecutarlo después de crear, editar o borrar un archivo de unit, por ejemplo en /etc/systemd/system. Recarga la configuración de systemd sin reiniciar ningún servicio, así que después hace falta un restart para que el proceso use los cambios.

¿Se corta la sesión SSH al reiniciar el servicio ssh con systemctl?

Reiniciar el servicio ssh con systemctl normalmente no corta las sesiones abiertas, porque cada conexión tiene su propio proceso. El riesgo está en las conexiones nuevas: si la configuración tiene errores, el servicio no vuelve. Valida antes con sudo sshd -t y mantén una segunda sesión abierta.

¿Cómo comprobar en un script si un servicio systemd está activo?

Un script comprueba si un servicio systemd está activo con systemctl is-active --quiet nombre. El comando sale con código 0 si la unit está activa y con otro valor si no, sin imprimir nada. Se puede encadenar con && o || o usar dentro de un if.