[Environment]

Format: arbitrary pairs

Environment variable substitions apply.

---

This section is for the setting of environment variables. The key names are the environment variables, and the values are the values which are assigned to them.

There are no fixed values which must go in here; all data is in arbitrary INI pairs. A few examples:

[Environment]
PATH=%PATH%;%PAL:AppDir%\AppName
APPNAME_HOME=%PAL:DataDir%\settings

Here, PATH will have ;%PAL:AppDir%\AppName appended to it (as %PATH% will be expanded) and APPNAME_HOME will be set to something like X:\PortableApps\AppNamePortable\Data\settings.

All values are parsed in the order they are come across, and the [Environment] section is parsed before all others that can “do anything”, thus you can, in a way, store a variable if you want to, for use in later [Environment] pairs or in another section such as a [FileWriteN] section:

[Environment]
LongSettingFile=%PAL:DataDir%\settings\.metadata\this.is.a.long.path\and.it.gets.used.a.number.of.times\file.conf
LongSettingFileDBS=%PAL:DataDir:DoubleBackslash%\\settings\\.metadata\\this.is.a.long.path\\and.it.gets.used.a.number.of.times\\file.conf
SomeEnvVar=%SomeEnvVar%;%LongSettingFile%

[FileWrite1]
Type=Replace
File=%LongSettingFile%
Find=%PAL:LastDrive%\\
Replace=%PAL:CurrentDrive%\\

[FileWrite2]
Type=Replace
File=%PAL:AppDir%\AppName\setting-file.conf
Entry=config.filename=
Value=%LongSettingFileDBS%

For a list of the extra environment variables that the PortableApps.com Launcher makes available, see Environment variable substitions.