Register RunOnce action

The Register RunOnce action registers an external program to run when the target system is next restarted, for example to perform post-boot installation actions.

Registration takes place under the Software\Microsoft\Windows\CurrentVersion\RunOnce registry key, either under HKEY_LOCAL_MACHINE for an All Users installation, or under HKEY_CURRENT_USER for a Current User installation. In the latter case, the external program will run the next time that the installing user logs into the system; in the former, it will run whenever the system is restarted regardless of the active user.

Note: You can also register external programs for post-boot execution by creating the appropriate registry entries on the Registry project page. However, the Register RunOnce action allows more flexibility in the scheduling of its execution than a registry value installation.


The following attributes and options are available.

Attribute Description
Action name Enter the name of the action. This name is only used in InstallMate and is not visible to the user.
Target path Enter the target path for the post-boot program, or click ... (browse) to open the Select Installation File or Folder dialog box that allows you to select an installation file.
Arguments Enter the arguments for the external program, if any. If an argument contains spaces (or may expand to contain spaces if you use symbolic variable references), then you must quote the argument, for example "argument with spaces" or "<INSTALLDIR>".
Defer delete Check this box to defer the deletion of the program's registration until the program has completed; clear it to remove the registration just before the program starts. This option is useful to ensure that the program will be started again if a previous attempt failed.
Safe mode Check this box to start the program even if the next system restart takes place in Safe Mode; clear it to skip it if the system restarts in Safe Mode. You should be careful if you use this option, because a Safe Mode restart usually indicates some sort of problem on the target system, and starting your program under those circumstances might cause the Safe Mode restart to encounter additional problems.
Condition Enter the conditional expression that determines if the action will be executed, or leave empty for unconditional execution.
Disabled Check this box to disable the action. A disabled action is not included in the installer and not checked during the build. You can use this option to remove actions temporarily from your installer without permanently deleting them. Disabled actions are shown with a grayed-out icon.
Platforms... Click this button to open the Select Installation Platforms dialog box that allows you to select the Windows versions on which the action must be executed. This platform selection acts as an additional condition for the action.

Related topics

Actions, Working with attribute panes