Viewing logs

Application logs (SSH)

Nexus runs as a Docker container. To stream live application logs:

docker compose -f /opt/nexus/docker-compose.prod.yml logs -f app

To view the last N lines without following:

docker compose -f /opt/nexus/docker-compose.prod.yml logs --tail=100 app

To view database container logs:

docker compose -f /opt/nexus/docker-compose.prod.yml logs -f db

Application logs include Phoenix request logs, Oban job activity, Elixir Logger output, and any errors from extensions.

---

Admin log panels

Two log views are available in the admin panel at Admin → Logs.

Job failures

Shows Oban background jobs in discarded or retryable state. Each row displays:

• State (discarded or retryable)
• Worker module name
• Queue
• Attempt count (current/max)
• Last error message
• When it was last attempted

This view covers all Oban queues — Nexus core jobs as well as extension jobs. A healthy installation shows no entries here.

Settings changes

Shows a history of admin panel setting changes. Each entry records which admin made the change, which settings section was modified (general, appearance, registration, etc.), the old value, and the new value, with a diff view highlighting exactly what changed.

---

Moderation log

The moderation action log is at Admin → Logs and is separate from the two panels above. It records every moderation action — bans, mutes, suspensions, post hides, post deletes, and composition analysis outcomes. See Moderation tools for the full list of logged actions.