Skip to content

File Migration Settings

Sandboxie Plus

SandMan > Sandbox Options > General Options > File Migration

Sandboxie normally lets a sandboxed program read a host file without first copying it. When the program requests an operation that needs to change an existing file, Sandboxie migrates the file into the sandbox and applies the change to that sandbox copy. The host file remains unchanged.

In SandMan, the File Migration page controls the normal size decision and the path rules that can override it.

Sandboxie Control Classic

Sandboxie Control > Sandbox Settings > File Migration:

Sandboxie Control Classic remains supported. Its File Migration page handles existing migration-size controls such as CopyLimitKb and CopyLimitSilent. The newer migration-rule actions documented below describe the current SandMan interface and do not imply equivalent controls in Sandboxie Control Classic.

Migration rules

The rule list supports four actions:

  • Always copy (CopyAlways) migrates the matching host file with its contents, without applying the normal size threshold.
  • Don't copy (DontCopy) prevents content migration. The open is retried without write and delete access, or denied when CopyBlockDenyWrite is enabled.
  • Copy empty (CopyEmpty) creates a zero-length sandbox copy instead of migrating the host contents.
  • Copy newer (CopyNewer) refreshes an existing sandbox copy when the matching host file has a later last-write time.

The first three actions select how an existing regular host file is initially migrated. If their patterns overlap, DontCopy takes priority over CopyAlways, which takes priority over CopyEmpty. CopyNewer is a separate check for a sandbox copy that already exists.

Rules may be repeated and may be limited to a program. See the dedicated setting pages for syntax, pattern behavior, and open-mode limitations.

Normal size decision

When no initial-migration rule matches, Sandboxie compares the host file size with CopyLimitKb. A file strictly smaller than the configured threshold is copied with its contents; setting the limit to -1 disables the size limit. For a file that reaches or exceeds the threshold, SandMan can prompt the user according to PromptForFileMigration. If migration is not approved, the open falls back to read-only access or is denied according to CopyBlockDenyWrite.

CopyLimitSilent controls message SBIE2102 when the size decision prevents migration and no prompt result is returned. NotifyNoCopy separately controls messages SBIE2113, SBIE2114, and SBIE2115 for explicit CopyEmpty and DontCopy rules.