Main > Reference Manual > Download and install > Installing on Windows > Windows installer

Installing and uninstalling frePPLe is straightforward, and follows the normal Windows conventions.

After accepting the license agreement, the installer will guide you to select:

  • The components to install
  • The installation directory
  • The database connection parameters
  • Whether or not to register the server as a service

With all options included the installation requires between 30 and 60 MB of disk space, depending on the selected options.

  1. Select the components to install.
  2. Select the installation directory.
  3. Select the installation parameters.
    Two types of parameters are specified during the installation:
    • Default language for the user interface
    • Database connection parameters
    FrePPLe supports the MysSQL, PostgreSQL 8, SQLite and Oracle 11g databases. The installer will detect which of those you have installed on you computer and allow you to choose one. The SQLite database is included with frePPLe, allowing you to get started very quickly.
    For MySQL, Oracle 11g and PostgreSQL 8 you need to specify the database name, the database user and its password, and the host and port number of the database engine. The database and the database user have to be created by the database administrator. The frePPLe database tables will be created when you first start the server.
    Make sure the database user has been created and has been granted sufficient privileges to create tables and indexes.
    For SQLite you only need to specify the database name.
    You selections are saved in the file server/settings.py. The file can later be edited with a text editor when required.
  4. Installation
    During the actual installation you can see the list of installed files.
  5. Finish
    At the end of the installation you can choose to start the server immediately.
    For an installation in production mode, you can also chose to register a service. For a test or development installation it is recommended to run the server from the console.
  6. Start the server
    FrePPLe's user interface is web-based. You need to start the web server first in one of the following ways:
    • Either it was already started at the last step of the installation process
    • Select "Run Server" from the program menu to start the web server in a console window.
      If you're new to frePPLe, this method is preferred.
    • Select "Start Service" from the program menu to run the server as a windows server. This option is available only when you choose the option to register a service during the installation.
    • Start the service from the windows service manager. Also this option is only valid if you choose to register the service during installation.
    Point your browser to the URL shown in the server window, and you're up and running!


It is possible to have multiple installations in parallel on the same computer. They need to be installed in different directories, and you need to set the environment variable FREPPLE_HOME to point to the directory with the version you want to run. Only one of them can be registered as a service.