Skip to main content

Troubleshooting

Last updated: 10 August 2026

Solutions to the problems users hit most often.

Before anything else, two things are worth knowing:

  • The Log panel on the main window shows what the Ingester has been doing. Most problems announce themselves there first.
  • The Open logs button opens the folder with the full log files. Always include these when reporting a problem.

Start here​

SymptomGo to
Files appear in the folder but no jobs are createdNothing happens when files appear
Jobs are created but sit thereJobs pile up but nothing uploads
An upload never gets past 0%Upload is stuck at zero progress
Access DeniedAccess denied when uploading
Contest code not recognizedContest code not recognized
Please select a partnerPlease select a partner
API Configuration IncompleteAPI Configuration Incomplete
The overlay logo is rejectedOverlay Image URL Error
The program closes on startupFailed to load Ingest Partners
It says another copy is runningAn instance is already running
It refuses to closeThe Ingester will not close
Registration or licence troubleRegistration and licence problems
A job is stuck and you want to try againRe-running a job

Nothing happens when files appear in the watch folder​

Work through these in order:

  1. Is WATCHER switched on? The button at the top must be blue. Without it, nothing scans the folders.
  2. Are the watch folders correct? Open SETTINGS and check. Folders that do not exist are dropped when you save — if a path is missing from the list, it was mistyped or the drive was not connected.
  3. Is the file extension in the list? A .mov file is ignored unless .mov is in Video file extensions.
  4. Is the API configuration complete? Backend System, API url and API key must all be set. Without them the Ingester will not create jobs at all.
  5. Is the Video CutterV2 still writing? If the companion .json file says FinishedCutting: false, the Ingester deliberately skips the file and writes "Skipping … because FinishedCutting is not yet true" to the log. It will pick it up once cutting completes.
  6. Was the file cancelled before? With Ignore Canceled ticked, a previously cancelled file is never picked up again. Untick it and rescan.

Click Rescan folders to force an immediate scan rather than waiting for the automatic one.

Jobs pile up but nothing uploads​

Check that WORKER is switched on. If it is off while jobs are waiting, the WORKER button blinks amber and the taskbar icon flashes — that is exactly this situation.

If WORKER is on and jobs still do not move, check the Connected indicator in the top-left corner.

Upload is stuck at zero progress​

Usually a slow or unstable connection combined with a chunk size that is too large.

  1. Open SETTINGS and set File chunk size to 5 MB. Click Save settings.
  2. Right-click the stuck job and choose Cancel.
  3. Click Show all jobs, find the cancelled job, right-click it and choose Re-run "your file".

If the link is shared with a live stream or scoring traffic, also consider setting an Upload rate limit so the Ingester stops competing with them.

Access denied when uploading a file​

An Access Denied message means the API key is missing, wrong, or not authorised for this backend.

  1. Open SETTINGS → API Configuration.
  2. Check the API key — retype it rather than editing it, to rule out stray spaces.
  3. Check that the Backend System matches the key. A JudoManager key will not work against Judobase.
  4. Click Save settings.
note

The change only takes effect after Save settings. Closing the dialog with Cancel discards it.

File upload failed – contest code not recognized​

Every video is linked to a fight by its contest code. For the upload to succeed, that code must exist in the backend the Ingester is pointed at.

The message means the backend was reached, understood the request, and found no such contest. The usual causes, in order of likelihood:

  1. Wrong Backend System. You are uploading a JudoManager contest while configured for Judobase, or vice versa. Open SETTINGS and check the Backend System dropdown — the API url should read https://datav2.judomanager.com for JudoManager and https://datav2.ijf.org for Judobase.
  2. Wrong partner (JudoManager only). The contest code must exist for that partner. Re-open the Contest Data form and select the correct partner.
  3. Typo in the contest code. Check it character by character against the source.
  4. The contest does not exist yet. If the draw or the schedule has not been published in JudoManager, its contests do not exist yet. Cancel the job, wait, and re-run it.

Please select a partner​

Shown when saving the Contest Data form for a JudoManager job without choosing a partner. The partner is mandatory for JudoManager because a contest code is only unique within one partner's events.

Choose the federation or organisation that owns the event from the Partner dropdown. If you are not sure which one, ask the Control Room team.

note

The Partner dropdown does not appear at all when the Backend System is Judobase — Judobase does not use partners.

note

This replaces the older IdPartner setting in settings.json. Partners are now chosen per job in the Contest Data form and are read from IngestPartners.json, so there is nothing to edit by hand.

API Configuration Incomplete​

Please select a Backend System (JM or JB) and provide both the API URL and API Key. All three settings are required for this process to run.

Exactly what it says: one of the three API Configuration settings is empty. The Ingester refuses to save incomplete settings and refuses to create jobs, because a job created without them could never be uploaded.

Choose a Backend System first — the API url fills itself in — then paste the API key.

Overlay Image URL Error​

The overlay image URL … must be a valid HTTP or HTTPS address. Local file paths are not supported.

The overlay image is fetched by the encoder, which runs in the cloud and cannot read your local disk. Upload the logo somewhere reachable over the internet and paste that address instead of a path such as D:\logos\sponsor.png.

Use the Open URL button to confirm the address really shows the image.

Failed to load Ingest Partners, and the program closes​

The file IngestPartners.json is missing or invalid. Application will now close. Contact support for help.

IngestPartners.json lives in the installation folder and lists the JudoManager partners offered in the Contest Data form. Without it, JudoManager jobs could not be given a partner, so the Ingester stops rather than running in a broken state.

Reinstall the Ingester, which restores the file. Do not edit it by hand.

An instance of the application is already running​

Only one Ingester can run at a time, because two copies would compete for the same job database. The first copy is still running — look for it in the taskbar or the notification area.

The Ingester will not close​

Some jobs are processing, so the application cannot close. Please wait for jobs to complete or cancel each job individually.

This is deliberate. Stopping mid-upload leaves a partial multi-part upload in cloud storage. Either wait for the current jobs to finish, or cancel them first and then close.

Registration and licence problems​

See Registration and licensing for machine key changes, expired tokens and expired licences.

Log files​

Everything the Ingester does is written to disk, in far more detail than the Log panel shows. The Open logs button opens the folder directly:

C:\FairReplay\Ingester\logs
FolderContents
app\The main application log — one file per day. Start here.
thread\The detailed upload and HTTP log — one file per day. Needed for upload problems.

Open them with Notepad or any text editor. Files are archived once they pass 100 MB, and the 4 most recent archives are kept, so a busy event does not fill the disk.

When reporting a problem, send the newest file from both folders rather than one of them — an upload failure usually needs the thread log to explain it.

Collecting information for a support request​

  1. The version from the title bar, e.g. 2026.06.01.337-be888ea.
  2. The Id job of the affected job, from the grid.
  3. The payload — right-click the job and choose Show payload for ….
  4. The log files — click Open logs and attach the newest file from both the app and thread folders.
  5. The exact wording of any error message.