FAQ

A student stays "Not connected" and can't reach the teacher

Check in order:

1. Same subnet: teacher and students on the same LAN/subnet (can ping each other).
2. Teacher running: the teacher app must be running to broadcast.
3. Same channel: students default to channel 1; the channel chosen on the teacher's first launch must match.
4. Ports open: allow UDP 11100 and TCP 11100–11105 (the Windows installer configures the firewall; on Linux watch ufw/security software).
5. Isolation: "AP/client isolation" on switches/APs blocks broadcasts — turn it off.

Teacher app says "this computer is not marked as a teacher, will not start"

The machine's name isn't recognized as a teacher. Either:

• Rename the computer to include teacher or a -t tag (e.g. teacher-1, PC001-T) and reboot, then start the teacher app;

• In a cloud-desktop environment, change the cloud-desktop computer name (it takes precedence over the OS hostname) — see Auto-detection.

• As an emergency override, start it skipping the check:

  # Linux
  /opt/cc-class/TeacherApp --no-host-check

  # Windows
  & "C:\Program Files\cc-class Electronic Classroom\TeacherApp.exe" --no-host-check

A student is misdetected as a teacher (or vice versa)

• The role depends only on the computer name. Check whether the name accidentally contains a -t/teacher tag.

• In cloud-desktop setups the cloud-desktop name wins — verify the name the platform pushes to that machine.

• On Linux, check the decision log for the name the software detected:

  cat /tmp/cc-class-service.log     # contains "Effective computer name=[...], role=TEACHER/STUDENT"

• After renaming, reboot — the daemon re-evaluates the role and rebuilds/cleans the desktop icon.

Linux teacher warns "Wayland detected, broadcast/remote control unavailable", or broadcast is black

Wayland sessions can't capture the screen or inject input. Switch to Xorg:

• The installer already wrote WaylandEnable=false; log out and back in, choosing an Xorg session at the login screen, or reboot.
• Verify: echo $XDG_SESSION_TYPE should print x11.

No shortcut appeared on the desktop

• Student machines deliberately have no desktop icon (by design); the application menu still has an entry.
• If a teacher machine has no icon: confirm it's actually detected as a teacher; reboot so the daemon rebuilds it. On Linux the icon is automatically marked "trusted" to avoid GNOME's "untrusted launcher" issue.

Will multiple classes in one room interfere?

No — give each class's teacher/students a different teaching channel. Students only connect to a teacher on the same channel.

How many students can connect?

The trial allows up to 5. For more, use Register Software in the teacher app with the "machine code" to obtain a license key.

The student app won't close / keeps restarting

This is intentional: the background service guards the student app and relaunches it if closed or crashed, so control is never interrupted. To stop it permanently, uninstall as administrator, or on Linux systemctl stop cc-class-student.

Do I need to reinstall after renaming a machine?

No. Just reboot — the software re-evaluates the role and handles the icon and service automatically.