Install Hoaka

About an hour for the server and the install stick, then a few minutes for each computer.

Your server computer

No files yet?Ask for the free three months

Before you start

  • A server computer64-bit, 40 GB free, on all day.
  • A fixed address for itWired to the lab network. Ask IT to reserve its address in the router.
  • The lab computers64-bit, able to start from a USB stick, each on the network by cable. Their disks are erased.
  • A USB stick16 GB or more, and balenaEtcher, free at balena.io/etcher.
  • The files we sendhoaka-server-windows-amd64.exe and the lab system as a .zip. The links work for 7 days.
  • The networkPorts 8080 for teachers and 8443 for lab computers, on the staff network only, never open to the internet.
01

Install the server

  1. Double-click hoaka-server-windows-amd64.exe.
  2. If Windows says "Windows protected your PC": More info, then Run anyway, then Yes.
  3. Note the console address, http://…:8080/, and the server key it prints.
02

Set up the server

  1. Fill in University name, Your name and Password, then press Set up and sign in.
The setup page
  1. Closed the page too early? In a Command Prompt opened as administrator:
  2. "C:\Program Files\Hoaka\hoaka-server.exe" -setup-code
03

Load the free licence

SettingsLicence

  1. Press Try free for 3 months, type how many computers, then Send by email.
  2. We answer with a licence file: Choose the licence file, then Load.
The Licence page with the free trial request
04

Add the rooms

Rooms

  1. Press Create room once for each lab, for example "Lab 204".
The Create room dialog
05

Make the install stick

SettingsLab computersLab installer

  1. On the server computer, so the large file stays off the network.
  2. Right-click the .zip, then Extract All.
  3. Press Choose the file and pick the .raw file.
  4. Press Download lab installer.
  5. In balenaEtcher: Flash from file with the .img, Select target with the stick, then Flash!. It erases the stick.
The Lab installer card
06

Install each lab computer

  1. In the BIOS or UEFI settings (often F2, F1 or Del at power-on): turn off Secure Boot and CSM, and set a BIOS password so nobody starts it from another stick.
  2. Plug in the stick and choose it in the boot menu (often F12, F11, F9 or Esc).
  3. Choose the computer's own disk, then Install and Erase and install.
  4. Pull out the stick when it says so.
  5. Choose the Room, type the Computer number, then Continue. Check that the Server key matches the one the server printed, then Confirm.
  6. It shows up under Devices in the console. On to the next computer.
The installer's disk choice
The naming screen
A new computer under Devices

Running the lab

Rooms
Switch a room between Open, Lecture and Exam, and send a page to every screen.
Exams
Start one with your exam page's link. Its computers open only that page until it ends.
People
Add teacher accounts and give each one their rooms.
Updates
New versions arrive by themselves, never during an exam.

Stuck?

Send a photo of the screen and the step number.