Pods - Aggregate Pod Management¶

Overview¶

The pods command provides aggregate management for all AI pod services. It shows combined status and enables bulk operations across all running pod containers.

Key Concept: This is a meta-command for managing multiple pods at once. For individual pod management, use the specific service command (e.g., ujust ollama, ujust jupyter).

Quick Reference¶

Parameters¶

ACTION Parameter¶

ujust pods ACTION=""

Without ACTION, shows interactive menu (requires TTY).

Commands¶

Status¶

ujust pods status

Shows status of all pod services:

• Container running state
• Port bindings
• GPU attachment
• Resource usage

Output includes:

• Ollama
• Jupyter
• ComfyUI
• Open WebUI
• LocalAI
• FiftyOne
• Jellyfin
• GitHub Runners

Purge¶

ujust pods purge

Removes all pod containers and their configurations:

1. Stops all running pods
2. Removes all pod containers
3. Cleans up Quadlet configs
4. Reloads systemd

Warning: This removes ALL pod containers. Data in workspace directories is preserved.

Common Workflows¶

Check All Services¶

# Quick status overview
ujust pods status

Clean Restart¶

# Remove all pods
ujust pods purge

# Reconfigure and start individual services
ujust ollama config
ujust ollama start

Before System Update¶

# Check what's running
ujust pods status

# Stop all if needed
ujust pods purge

Non-Interactive Usage¶

All commands work without TTY:

# CI/automation-friendly
ujust pods status
ujust pods purge

Troubleshooting¶

Status Shows Stale Containers¶

Symptom: Status shows containers that don't exist

Cause: Quadlet configs out of sync

Fix:

systemctl --user daemon-reload
ujust pods status

Purge Doesn't Remove All¶

Symptom: Some containers remain after purge

Cause: Containers created outside Quadlet

Fix:

# Manual cleanup
podman ps -a
podman rm -f <container-id>

Cross-References¶

• Individual Services: ollama, jupyter, comfyui, openwebui, localai, fiftyone, jellyfin, runners skills
• Testing: test pods for lifecycle testing