====== Ubuntu Server Maintenance Quick Commands ======

This page contains common maintenance and troubleshooting commands for the Ubuntu server.

===== Server Health Check =====

Checks the main native services and important Docker containers:

<code bash>
echo "=== Native Services ==="
for s in plexmediaserver transmission-daemon jdownloader; do
  printf "%-22s %s\n" "$s" "$(systemctl is-active "$s" 2>/dev/null)"
done

echo
echo "=== Docker Services ==="
for c in nginx-proxy-manager newsblur_web newsblur_celery newsblur_nginx newsblur_haproxy; do
printf "%-22s " "$c"
docker inspect -f '{{.State.Status}}' "$c" 2>/dev/null || echo "not found"
done </code>

Healthy results should normally show:

<code>
plexmediaserver        active
transmission-daemon    active
jdownloader            active

nginx-proxy-manager    running
newsblur_web           running
newsblur_celery        running
newsblur_nginx         running
newsblur_haproxy       running </code>

===== Show All Running Docker Containers =====

<code bash>
docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
</code>

===== Check Individual Services =====

Plex:

<code bash>
systemctl status plexmediaserver --no-pager -l
</code>

Transmission:

<code bash>
systemctl status transmission-daemon --no-pager -l
</code>

JDownloader:

<code bash>
systemctl status jdownloader --no-pager -l
</code>

===== Check Listening Ports =====

Show all listening TCP ports:

<code bash>
sudo ss -ltnp
</code>

Common important ports on this server include:

<code>
80       Nginx Proxy Manager HTTP
443      Nginx Proxy Manager HTTPS
32400    Plex
9095     Transmission Web/RPC
51413    Transmission peer traffic
8084     DokuWiki
8085     WordPress
8086     NewsBlur
</code>

===== Check Plex Locally =====

<code bash>
curl -I http://127.0.0.1:32400/web
</code>

If Plex is healthy, it should respond instead of reporting connection refused.

===== Check NVIDIA Driver =====

<code bash>
nvidia-smi
</code>

If this reports:

<code>
Failed to initialize NVML: Driver/library version mismatch
</code>

the NVIDIA libraries and loaded kernel module do not match.

Reboot the server before troubleshooting Plex further:

<code bash>
sudo reboot
</code>

===== Normal Ubuntu Update Procedure =====

Refresh package information:

<code bash>
sudo apt -o Acquire::ForceIPv4=true update
</code>

Review available updates:

<code bash>
apt list --upgradable
</code>

Install normal eligible updates:

<code bash>
sudo apt -o Acquire::ForceIPv4=true upgrade
</code>

Packages held back because of "phasing" can normally be left alone.

===== Check Whether a Reboot Is Required =====

<code bash>
if [ -f /var/run/reboot-required ]; then
  echo "REBOOT REQUIRED"
  cat /var/run/reboot-required.pkgs 2>/dev/null
else
  echo "No reboot required"
fi
</code>

Pay special attention if updates include:

<code>
linux-image
linux-headers
nvidia-driver
nvidia-utils
libnvidia
nvidia-kernel
</code>

After kernel or NVIDIA updates, reboot when Ubuntu requests it.

===== Reboot =====

<code bash>
sudo reboot
</code>

After reconnecting, run:

<code bash>
nvidia-smi
</code>

and then the normal server health check.

===== Disk / Mount Checks =====

Show mounted filesystems:

<code bash>
findmnt
</code>

Show mounted media drives:

<code bash>
findmnt | grep /mnt
</code>

Show disk space:

<code bash>
df -h
</code>

Show disks and filesystem information:

<code bash>
lsblk -f
</code>

===== Test /etc/fstab =====

After editing ''/etc/fstab'':

<code bash>
sudo systemctl daemon-reload
sudo mount -a
</code>

Then verify mounts:

<code bash>
findmnt
</code>

External/data drives should normally use ''nofail'' so a missing drive does not prevent Ubuntu from booting.

===== Docker Compose Maintenance =====

From the directory containing a service's ''compose.yml'' or ''docker-compose.yml'':

Pull newer images:

<code bash>
docker compose pull
</code>

Recreate/update containers:

<code bash>
docker compose up -d
</code>

Remove unused Docker images:

<code bash>
docker image prune
</code>

Do not run these blindly for services where a specific application version must be preserved.

===== Recent Service Logs =====

Plex:

<code bash>
sudo journalctl -u plexmediaserver --since "today" --no-pager
</code>

Transmission:

<code bash>
sudo journalctl -u transmission-daemon --since "today" --no-pager
</code>

JDownloader:

<code bash>
sudo journalctl -u jdownloader --since "today" --no-pager
</code>

Docker container logs:

<code bash>
docker logs --tail 100 CONTAINER_NAME
</code>

Follow live Docker logs:

<code bash>
docker logs -f --tail 100 CONTAINER_NAME
</code>

Press ''Ctrl+C'' to stop following the log.

===== Useful Docker Commands =====

Show running containers:

<code bash>
docker ps
</code>

Show all containers, including stopped ones:

<code bash>
docker ps -a
</code>

Restart one container:

<code bash>
docker restart CONTAINER_NAME
</code>

Inspect container status:

<code bash>
docker inspect -f '{{.State.Status}}' CONTAINER_NAME
</code>

===== Quick Troubleshooting Order =====

When something appears to be down:

* Run the server health check.
* Check whether the service/container is running.
* Check whether its expected port is listening.
* Check recent logs.
* Check mounted media/data drives if the application depends on them.
* Run ''nvidia-smi'' if Plex is crashing after updates.
* Reboot if Ubuntu reports a reboot is required after kernel or NVIDIA updates.

===== Conservative Update Rule =====

For normal maintenance, prefer:

<code>
apt update
apt upgrade
</code>

Avoid routinely using:

<code>
apt full-upgrade
apt dist-upgrade
</code>

unless there is a specific reason to do so.

Do not force phased updates unless necessary.