### Help Sections Main Window Login Configuration File ### Create Release New Release File Selection Progress ### Edit Release Select Release Details File Selection Edit Release Status ### Other Preferences Submit News Freshmeat Setup Freshmeat Release Email Address Setup Email Announcement | # 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.