Skip to content
FEMNET

Fix common problems

Diagnose the issues most often reported by staff and learners.

IT teamDone in: Server5 steps
  1. 1

    Nobody receives codes

    Check docker compose logs drf for the emails. If they are printed there, email is not configured (see Domains and email). If sending fails, check the provider key and that the sender domain is verified.

  2. 2

    A learner's progress is missing

    Ask the learner to open Sync in the learner app and sync. Admins can check the in the hub's Settings and Sync Health for failed jobs; use Retry failed jobs there.

    Sync Health in the hub
  3. 3

    The apps show network errors

    Check /health/. If it fails, check docker compose ps and the drf logs. If it works, check CORS settings include the app's domain.

  4. 4

    Course pictures are broken

    Check the Caddy /media/ route and that the media folder is mounted and readable.

  5. 5

    Payments stay "Awaiting payment"

    Check the Paystack webhook URL and secret key, and look for webhook errors in the drf logs.

Related how-tos