Skip to main content

NinjaOne Backup — Error 312: Backup Repository Root Folder Missing

Audience: T1 / T2 Use when: Backup fails with "Error 312: Existing NinjaOne Backup repository root folder location missing."

What This Error Means

The backups/ninjaone root folder that NinjaOne previously wrote backup data to no longer exists on the NAS. The configured UNC path in NinjaOne points somewhere valid, but the specific folder within it that holds the backup repository is gone.

This is a straightforward configuration fix — the folder needs to be recreated and the backup re-initialized.

Common Causes

Cause What Happened
NAS was reset or factory restored Share recreated but the ninjaone subfolder wasn't
Someone manually deleted the backup folder Administrative error on the NAS
NAS volume was reformatted All data lost — start fresh
NAS replaced with a new unit New NAS, new shares — the old path doesn't exist

Step 1 — Confirm the Folder Is Missing

# Try to list the expected path
Test-Path "\\NAS-HOSTNAME\backups\ninjaone"

# Should return False if Error 312 is accurate
# If True: the folder exists — check NinjaOne path config instead

Step 2 — Recreate the Folder

On Synology:

  1. Log into DSM → File Station
  2. Navigate to the backups share
  3. Create a new folder named ninjaone
  4. Verify the dtcbackup user has Read/Write access to this folder (inherits from share if set correctly)

On QNAP:

  1. Log into QTS → File Manager
  2. Navigate to the backups share
  3. Create a new folder named ninjaone
  4. Verify permissions

Via PowerShell (if Windows has admin rights to the NAS):

New-Item -Path "\\NAS-HOSTNAME\backups\ninjaone" -ItemType Directory

Step 3 — Verify NinjaOne Storage Location Config

After recreating the folder:

  1. NinjaOne → Organization → Backup → Storage Locations
  2. The path should still read \\NAS-HOSTNAME\backups\ninjaone
  3. If the NAS hostname changed: update the path
  4. Re-save the storage location (even if unchanged) to force a re-validation

Step 4 — Trigger a Fresh Backup Run

After the folder is recreated:

  1. NinjaOne → device → Backup → Run Backup Plan
  2. NinjaOne will perform a new full backup to the recreated folder (first run takes hours)
  3. Monitor in Activities tab — confirm success

Note: All previous local revisions are gone if the folder was deleted. Cloud revisions are unaffected.

Back to top