Veyon Room Setup

By Wes Taylor | May 2026

1. Overview

This article documents how to configure a student machine for classroom monitoring using Veyon. Running the setup script will automatically create the necessary local group, add the teacher’s account, and register the room and all student computers in Veyon so they appear in Veyon Master.

The setup script handles:

• Creating a local Teachers group on the machine
• Adding the classroom teacher’s user account to that group
• Registering the room location and all student computer hostnames in Veyon’s network object directory

2. Assumptions

This setup was designed under the following assumptions:

• Veyon 4.x is already installed on the machine, or will be installed as part of this process.
• The machine is on the school network and can reach the Scripts share.
• You have administrator access to the machine.
• The batch file (Run-VeyonSetup.bat) has been copied locally before running — it cannot be launched directly from the network share.
• Room data is maintained in rooms.xlsx on the Scripts share.

3. Objectives

The primary goals of this setup process are:

• Allow teachers to monitor and manage student machines using Veyon Master
• Automate room configuration so it does not need to be done manually through the Veyon Configurator
• Keep all configuration data in one central location (the Scripts share) so changes only need to be made in one place
• Make the process repeatable — running the script more than once should not create duplicates

4. Technical Setup

This solution uses a PowerShell script called from a batch file. The script reads room data from a shared Excel file and calls veyon-cli.exe to configure Veyon.

5. Files on the Network Share

All files are located on the Scripts share. The batch file is the only file that needs to be copied locally.

6. rooms.xlsx Format

The Excel file has two sheets:

Sheet1 — Room Info

Sheet2 — Computer Hostnames

7. Setup Steps

1. Open the Scripts share in File Explorer
2. Copy Run-VeyonSetup.bat to the local machine
3. Right-click Run-VeyonSetup.bat and select Run as Administrator
4. The script will run automatically. You will see output for each step:
   • Step 1 — Installs Veyon if not already installed. If Veyon is detected, it will say “Veyon is already installed. Skipping.”
   • Step 2 — Reads the room data, creates the Teachers group, adds the teacher account, and registers all computers in Veyon
5. Press any key to close the window when complete
6. Open Veyon Master on the teacher machine to verify the room and computers appear

8. Adding a New Room

To add a new classroom to the system:

1. Open rooms.xlsx
2. Update Sheet1 with the teacher username and room number
3. Update Sheet2 with the full list of computer hostnames for the room (one per row)
4. Save the file
5. Run Run-VeyonSetup.bat on each machine in that room

9. Troubleshooting