Installation and setup
How to install JudoNet on a Windows PC and get it ready for a competition.
Requirements
- The PC must run 64-bit Windows. The installer adds the .NET 10 runtimes if they are missing, so nothing needs installing beforehand.
- You must be able to install software — the installer needs administrator rights, because it creates a Windows service. On a managed laptop you may need someone from IT.
- The PC needs an internet connection. JudoNet synchronises its clock on startup and sends data to the online platform, and both matter — see Time, and why it matters so much.
- The PC must be on the same local network as the scoreboards, the JudoManager server and (if used) the FairReplay Recorders, with broadcast and multicast traffic allowed between them. See Network requirements.
JudoNet needs no licence key and no registration. Unlike the Video CutterV2 and the Video Ingester, it starts working as soon as it is installed.
Which competitions is JudoNet for?
All of them. JudoNet works with both back-end systems that JudoManager desktop can use:
| Back-end | Typical use |
|---|---|
| JudoManager (JM) | National federation and club events. |
| Judobase (JB) | IJF events. |
You do not choose between them by hand. JudoNet reads which system the selected JudoManager server is using and configures itself to match — see API settings.
Installation
What you are downloading
A single file named JudoNetSetup_<version>.exe — for example JudoNetSetup_2026.08.10.326-d3ca87b.exe. The version in the file name is the same version JudoNet later shows at the top of its left-hand menu, so it is worth noting which one you downloaded.
The file is around 100 MB, because it carries the .NET runtimes with it and can therefore install on a PC with no internet connection of its own.
If your browser flags the installer as suspicious, download it anyway. The installer and all components of JudoNet are code-signed by Datastat d.o.o. — Windows will show that publisher name when you start it.
Before you start
- Stop JudoNet if it is already installed and running. Open JudoNet Monitor and press STOP SERVICE.
- Have the administrator password ready.
- If this PC has been used for a previous competition, plan to back up and clear the database afterwards.
Step by step
The whole process takes a few minutes and asks you almost nothing. There is no page asking where to install and no options to choose — the only decision is at the very end, and its default is correct.
1. Run the file. Double-click the downloaded JudoNetSetup_...exe.
2. Allow it to make changes. Windows darkens the screen and shows a User Account Control prompt — a small dialog asking "Do you want to allow this app to make changes to your device?", with the publisher shown as Datastat d.o.o. Click Yes.
This prompt is expected and is not a warning that something is wrong. Administrator rights are genuinely needed here, not merely customary: the installer registers a Windows service, and JudoNet later adds firewall rules and adjusts the PC's clock settings. None of that is possible without them.
If you click No, nothing is installed and the installer simply closes. If the prompt asks for a user name and password instead of a simple Yes, the account you are signed in with is not an administrator — you need someone who is.
3. Wait for the splash screen. A picture appears for a moment while the installer checks what is already on the PC.
4. The installer checks for an existing JudoNet.
| What is on the PC | What happens |
|---|---|
| Nothing, or an older version | Installation continues. Your settings and database are kept. |
| The same version | "This version of JudoNet is already installed on your computer!" — click OK; the installer closes without changing anything. |
| A newer version | A message lists both versions and the installer closes. |
The check compares only the last number of the version — the build number. So 2026.08.10.**326** counts as newer than 2026.08.10.**115**.
5. .NET runtimes install. If the PC does not have them, three Microsoft installers run one after another, each with its own progress window: the .NET runtime, the ASP.NET runtime and the desktop runtime. This can take a few minutes.
These windows say Microsoft, not JudoNet, and they appear before the JudoNet setup wizard does. That is normal — JudoNet needs all three to run. Let them finish and do not close them, even though nothing seems to mention JudoNet yet. If the PC already has .NET 10, this step is skipped entirely and you go straight to the next one.
6. The setup wizard opens. Now the familiar wizard appears, starting with a welcome page. Click Next.
7. Confirm. A Ready to Install page summarises what is about to happen. There is nothing to change. Click Install.
8. Files are copied. JudoNet installs into \JudoNet on the system drive — the drive Windows itself is on, so C:\JudoNet on virtually every PC. There is no page asking where. Everything JudoNet owns — the programs, the settings, the database and the logs — lives in that one folder, which makes it easy to back up and easy to find.
9. The service is registered. The installer creates a Windows service called JudoNet.Service, set to start on demand.
"On demand" means JudoNet does not start with Windows. After installing — and after every restart of the PC — somebody has to open JudoNet Monitor and press START SERVICE. This is deliberate, so that JudoNet is only running when someone means it to be, but it is easy to forget after an unexpected reboot.
10. Finish. The last page offers a Run JudoNet now tick box, ticked by default. Leave it ticked and click Finish to open JudoNet Monitor straight away.
A JudoNet icon now sits on the desktop, and JudoNet appears in the Start Menu.
That icon opens JudoNet Monitor, not JudoNet itself. Nothing is running yet — the service still has to be started. This catches out almost everybody the first time; see the two programs.
What the installer changes on your PC
| Change | Detail |
|---|---|
| Program files | C:\JudoNet — the service, the Monitor, the database, settings and logs. |
| Windows service | JudoNet.Service, start type demand (manual). |
| Desktop shortcut | JudoNet, for all users, opening JudoNet Monitor. |
| Start Menu entry | Under JudoNet. |
| Uninstall entry | JudoNet in Apps & features. Uninstalling stops and removes the service. |
Additionally, JudoNet itself — not the installer — adds firewall rules the first time it starts with administrator rights:
| Firewall rule | Purpose |
|---|---|
_JudoNet NT Access | Lets JudoNet communicate on private and public networks. |
_JudoNet UDP 8888 | Receives announcements from scoreboards and JudoManager servers. |
_JudoNet UDP 18918 | Receives announcements from FairReplay Recorders. |
_JudoNet UDP 123 | Time synchronisation. |
Network requirements
| Direction | Protocol and port | Purpose |
|---|---|---|
| Scoreboards, JudoManager → JudoNet | UDP 8888 | The devices announce themselves. |
| FR Recorders → JudoNet | UDP 18918, multicast 239.225.89.212 | Recorders announce themselves. |
| JudoNet → scoreboards | TCP 855 (WebSocket) by default, or the port the scoreboard announces | The connection that carries the packets. |
| JudoNet → the network | UDP 8888 broadcast | JudoNet announces itself, so the Video CutterV2 can find it. |
| JudoNet → the network | UDP 5000 broadcast | Live data to CG - JudoGraphics. |
| JudoNet → the network | UDP 5001 broadcast | Markers and events to FairReplay Recorders. |
| Your browser → JudoNet | TCP 5220 (HTTP) | The web interface. |
| JudoNet → the internet | UDP 123, HTTPS | Time synchronisation and the online platform. |
The scoreboard port (855) and the two broadcast ports (5000, 5001) can be changed in Settings, and the discovery port (8888) can be changed in settings.json. The rest are fixed.
Non-default ports need their own firewall rules. The table above is the default case. A scoreboard that announces a port of its own is reached on that port rather than 855, and a JudoNet whose discovery port has been moved off 8888 needs a rule for the new port — the _JudoNet UDP 8888 rule created at installation covers 8888 only.
Scoreboards should be on the wired local network only. Disable Wi-Fi on scoreboard PCs. A scoreboard connected to two networks announces itself on both, appears twice in JudoNet, and creates confusion about which address to use.
Starting JudoNet for the first time
- Double-click the JudoNet desktop icon. JudoNet Monitor opens.
- Press START SERVICE. After a few seconds the status line reads JudoNet Service is currently RUNNING.
- Press Open In Browser. The JudoNet web page opens at
http://localhost:5220.
On that first start, JudoNet adds its firewall rules and synchronises the PC clock, so it may take a moment longer than usual.
Full detail of the Monitor's buttons is in JudoNet Monitor; what to do next is in Using JudoNet.
Upgrading
Installing a newer version over an older one is the normal way to upgrade. Your settings and your database are kept.
Stop the service in JudoNet Monitor first, then run the new installer.
Do not upgrade during a competition. Upgrading stops the service, and while it is stopped no packets are being received or stored — those moments are lost permanently, because JudoNet cannot ask a scoreboard what happened while it was not listening.
Uninstalling
Settings → Apps → Installed apps, find JudoNet, choose Uninstall. The service is stopped and removed.
Your database, settings and logs in C:\JudoNet are not removed. Delete the folder by hand if you want the PC completely clean — but make sure the competition data in it has been backed up first.