Troubleshooting and operations

​

Check service health

docker compose ps
curl -fsS http://127.0.0.1:5000/api/health
docker compose exec postsider wget -qO- http://localhost:3002/health/workers

​

Read logs

docker compose logs --tail=200 postsider
docker compose logs --tail=200 temporal
docker compose logs --tail=200 postgres

​

Monitoring and alerting

• /api/health reports redis, database, and temporal status and returns 503 when any of them is degraded (not a green 200).
• /health/workers inside the container reports per-queue worker state and 503s when a worker is not polling - the main queue carries every publish workflow.
• The optional Temporal UI at 127.0.0.1:8080 (SSH tunnel) shows workflows and the main task queue.
• Inspect the queue with the Temporal CLI:
  docker compose exec temporal temporal task-queue describe --task-queue main --address temporal:7233
  
  0 pollers means the workers are down and scheduled posts will pile up in QUEUE without errors.
• Point an external uptime monitor at /api/health (HTTP mode) and /health/workers if reachable. On self-hosted instances set up log rotation and a disk/restart alert.

​

A post missed its scheduled time

1. Check /api/health.
2. Check /health/workers from inside the application container.
3. Confirm the post is not in ERROR state.
4. Inspect docker compose logs postsider for Temporal or provider errors.
5. Check the connected channel and provider OAuth token.

​

Upgrade safely

git fetch --tags origin
git checkout v1.0.1
docker compose up -d --build --wait

​

Restore checklist