ReleaseForge Configuration File

As of v0.9.0 ReleaseForge now requires a data directory in order to start. Typically, this directory is a subdirectory of the user's home directory. Namely, ReleaseForge, by default, will use $HOME/.releaseforge as it's data directory.

When ReleaseForge is initially launched this directory will be created if it does not already exist. In the event that ReleaseForge cannot determine the $HOME environment variable the user has two options:

Explicitly set the $HOME environment variable
Supply a data directory parameter on the command line

Setting the $HOME environment variable

This varies depending on the operating system or shell so it is recommended that you consult your systems (or shells) documentation for the specific syntax. If you are using the bash shell then you can set this value accordingly:

$ export HOME=/home/foo
$ python releaseforge.py

This will result in ReleaseForge creating (if necessary) the directory /home/foo/.releaseforge and using it to store it's data.

Supply the data directory parameter on the command line

Use the --data flag to specify a data directory to use. This path should be absolute. For example, to use /home/foo/.releaseforge as your data directory you would launch ReleaseForge as such:

$ python releaseforge.py --data=/home/foo/.releaseforge

As in all cases, this will result in ReleaseForge creating (if necessary) the directory /home/foo/.releaseforge and using it to store it's data.

Further configuration

Once ReleaseForge initially runs successfully, the file releaseforge.cfg will be created (if it does not already exist) in ReleaseForge's data directory (usually $HOME/.releaseforge). This initial configuration file will be populated minimally. It is recommended that the user select Preferences from the Edit menu of ReleaseForge's main window and then edit their settings accordingly and click Ok.

Please see the preferences page for further information.