Apple Classroom
Relution distributes the configuration for using the Classroom app to Apple devices managed by Relution (iPadOS / macOS). Apple Classroom is an app used in the education sector to enable teachers to control and monitor student devices during lessons.
Requirements
- Two devices registered in Relution (Supervised).
- At least two users.
- The Apple Classroom app must be installed on one device (teacher).
- A valid Education or Free license for Relution.
Network preparation
- The devices must be on the same network if Classroom is to be used.
- Client-to-client communication must be possible in the Wi-Fi network.
- Port 3284: For sharing documents via Classroom.
- Port 3285: For communication with the Classroom app.
User preparation
- At least two users are required (one teacher and one student).
- Classes must be created under
Education→Classes. This step can be automated by importing via an interface (e.g. LDAP or Apple School Manager); alternatively, users and classes can be imported via a CSV file. Relevant manual articles:- CSV import: Import users via CSV →
- LDAP integration: LDAP configuration →
- ASM import: Apple School Manager Import →
- SchulConnex import: SchulConnex Import →
- OneRoster: OneRoster Interface →
- Teachers and students are added to the class either individually or via user groups, e.g. via the groups
UIT - Teacher/UIT - Student. No specific group membership is required for Apple Classroom; what counts is only the entry as a teacher or student in a class. For the default groupsTeacher/Studentand their permissions in Relution, see Education function →.
Configuration
Relution distributes so-called education configurations to the devices.
These configurations contain information about which classes and students can be controlled by which teachers.
Classes that do not contain at least one teacher and one student are not included in the education configuration and therefore do not appear in Apple Classroom.
In addition to the classes, an active ad-hoc lesson from Relution Teacher is included in the education configuration as a separate group, see Relution Teacher →.
In order for the distribution of the education configuration to be successful, users must be assigned to the devices.
The assignment can be done either manually or via CSV file.
Alternatively, users can be assigned during Automated Device Enrollment (ADE, DEP in the portal): in the DEP profile under Devices → Profiles, User authentication is set to Username + Password. The device is then assigned to the user who signs in during enrollment. Details: Profile for ADE →.
If users are assigned this way, devices that are already enrolled must be reset (deleted) and then re-enrolled.
Shared iPads without an assigned user receive the education configuration via the classes stored in the Shared iPad settings → configuration of a policy, see Class lists (Shared iPad) →.
Troubleshooting
Occasionally, individual or multiple users may be displayed as offline for the teacher.
Possible causes and solutions:
Invalid or expired education configuration:
If the configuration is invalid, it must be reinstalled. To do this, the user must be removed from the class and reassigned.
If classes were created automatically via LDAP, the user must be removed from the device and reassigned. Note: Problems may occur when using dynamic device groups on a user basis.
Incorrect network configuration (ports or Wi-Fi networks):
- If the required ports are closed or the devices are in different WLAN networks, connection problems may occur.
- To check this, a mobile hotspot can be used to connect the devices to each other. If the devices are displayed as
onlinein this environment, the network configuration must be adjusted accordingly.