Sandboxie Ini

Some aspects of the operation of Sandboxie can be altered or fine-tuned through the use of a human-readable textual configuration file called Sandboxie.ini. This section describes the structure and contents of the file.

As a general rule, manual editing of the configuration file is discouraged. You are advised to use Sandboxie Control to make configuration changes. See Sandbox Settings.


Sandboxie looks for the file Sandboxie.ini in the following folders, in this order:

The search for Sandboxie.ini ends when an instance of the file is found, and all other instances are ignored.

When Sandboxie Control updates the configuration, it rewrites the file Sandboxie.ini file in the folder from which the configuration was last read. Thus, if the file is manually moved, Sandboxie configuration must be manually reloaded. (Restarting the computer would have the same effect.)

Note: Sandboxie does not support any other custom location for the Sandboxie.ini file.


Configuration settings in the file are split into groups, or sections. A section begins with a line that specifies its name enclosed within square brackets. For example: [SomeSectionName]. The section continues to the end of the file, or until another section begins. There are three types of sections:

A simple Sandboxie.ini file may look like this.

   # Sample Sandboxie Configuration File
   # Settings for sandbox DefaultBox
   # Settings for sandbox InstallBox
   # Sandboxie Control settings for some user

The example shows four sections: The global section (GlobalSettings), two sandbox sections (DefaultBox and InstallBox), and one user account section (UserSettings_054A02CE).

Lines that begin with a hash sign (#) are comments. These lines are skipped.

Note: During its operation, Sandboxie Control regularly rewrites the Sandboxie.ini file, and this rewrite loses all comments. However, unrecognized settings are not lost during the rewrite, so one workaround is to write comments in the form Comment=text.

The configuration file can contain up to 30,000 lines of text. Each line can be up to 1000 characters long.

The file is UNICODE-encoded, which means each character is composed of two bytes. Many text file editors, including the system Notepad, handle this encoding properly.


Global Settings:

Sandbox Settings:

In the example above, the sandbox setting FileRootPath appears in [GlobalSettings] and applies to all sandboxes, but note that it is overridden in section [InstallBox].

User Settings


Sandboxie includes a command-line utility to query or update the Sandboxie.ini configuration file. The utility is suitable for direct command-line interaction as well as invocation from a script or a program. The utility can be found as SbieIni.exe in the Sandboxie installation directory. For further details, see Create a sandbox by command line and SbieIni.exe usage section.