This tutorial will cover only the installation on Windows.
FrePPLe comes with easy and straightforward all-in-one installer. It installs frePPLe, Python, SQLite database and a Python web server. No other software is required.
This setup is suitable for this tutorial, but for a production system a more powerful and scalable setup is most probably required: see the installation guide for other deployment options.
- Download the windows installer from SourceForge.net.
Running the installation is as straightforward as it can be and frePPLe consumes maximum 40MB of disk space. For the purpose of this tutorial stick with the default installation options. In particular, make sure to choose the SQLite database during the installation. - The last step in the installation process allows you to start the server right away. Alternatively you can start the server from the start menu.
The server will open a new window, and will display the URL to point your browser to. - Open your browser (Chrome, Firefox, Internet Explorer, Safari and Opera have been tested) on this URL. The login screen will appear.
There are 3 initial accounts created in the system:- The user frepple, with password ‘frepple’, is a typical user account. The user has access to all functionality.
- The user admin, with password ‘admin’, is a system administration account with complete access to the system, plus user and permission management.
- The user guest, with password ‘guest’, is a user account with access to a limited subset of functionality.
Different user roles can easily be defined by the administrator to control the access rights. Try logging in for each of these accounts to see how the menus and screens automatically adjust according to the permissions of the user.
Throughout this tutorial you can continue to log in as the admin user. - The installation populates the database with a demo dataset. We’ll now erase it from the database to start with a clean slate.
Select ‘Tools’ / ‘Execute’ in the menu bar at the top of your screen, expand the ‘Database’ section and then click the ‘erase’ button in the database section. The screen will display a message at the top when the deletion is finished.
If you have been able to perform the above steps, your frePPLe installation is fully up and running!