Rename a Computer
C-Class uses the computer name to decide each computer's role, so set names before you install.
Choose a name
| Role | Pattern | Examples |
|---|---|---|
| Teacher | Room plus -T | S116-T, LAB2-T |
| Student | Room plus number | S116-01, S116-02 |
- Windows names can have up to 15 characters. Use letters, numbers, and hyphens.
- Linux hostnames should also use only letters, numbers, and hyphens.
- Every computer in a room needs a unique name.
- Avoid names such as
T01,T-01,LAB-TEAM, orROOM-T-05for student computers.
Windows
Windows 11: Go to Settings > System > About, select Rename this PC, enter the name, and restart.
Windows 10: Go to Settings > System > About, select Rename this PC, enter the name, and restart.
Windows 7: Right-click Computer > Properties, select Change settings, then Change. Enter the name and restart.
Or run this in an elevated PowerShell window:
Rename-Computer -NewName "S116-T" -Force -RestartLinux
sudo hostnamectl set-hostname S116-T
sudo sed -i "s/^127\.0\.1\.1.*/127.0.1.1\tS116-T/" /etc/hosts
grep -q '^127\.0\.1\.1' /etc/hosts || echo "127.0.1.1 S116-T" | sudo tee -a /etc/hosts
sudo rebootAfter restarting, confirm the result:
hostname
grep "Effective computer name" /tmp/cc-class-service.log | tail -1Cloud desktops
The name assigned by the cloud desktop platform takes priority. Rename the terminal in the management platform, then restart it.
Convert a student computer to a teacher computer
A managed student computer stays a student even after it is renamed. Do this instead:
Clear the binding using one of these options. Each requires the admin password.
- Student tray icon: right-click and select Unbind Teacher.
- Teacher app: open System Control > Remote Settings, select the computer, check Unbind Teacher, and apply.
- Command line:
powershell& "C:\Program Files\C-class Electronic Classroom\StudentApp.exe" --clear-guard "ADMIN_PASSWORD"bashsudo /opt/cc-class/StudentApp --clear-guard 'ADMIN_PASSWORD'Rename it right away. If it reconnects to a teacher first, the binding comes back.
Restart.
Confirm that the teacher icon appears and the teacher app opens.
Convert a teacher computer to a student computer
- Close the teacher app.
- Rename the computer to a student name and restart.
- Clean up the icon. Linux does this at boot. On Windows, run the installer again or delete the icon.
Troubleshooting
| Symptom | Fix |
|---|---|
| "Not marked as a teacher computer" | Rename to xx-T and restart |
| Still a student after renaming | Clear the binding first |
| Teacher app asks for an admin password | Enter it once. See Passwords |
| OS name is right but role is wrong | Rename it in the cloud desktop platform |
| Old name remains as a gray card | Delete the card. See Uninstall and Remove Clients |