============= Lokole README ============= This Ansible role installs the `Lokole web app `_ within Internet-in-a-Box. Lokole is a project by the Canadian-Congolese non-profit `Ascoderu `_. The Lokole is a simple email client that offers functionality like: 1. Self-service creation of user accounts 2. Read emails sent to the account 3. Write emails including rich formatting 4. Send attachments Using It -------- The Lokole web app can be accessed at http://box/lokole. Administration -------------- Every Lokole installation has an admin account named ``admin``. By default, the password is ``changeme1``. Administrators can: - Suspend and reinstate user accounts - Change passwords of user accounts (TODO: admin accounts too?) - Promote users to the admin role All of these actions can be performed from the page http://box/lokole/users. Account Suspension ~~~~~~~~~~~~~~~~~~ Administrators have the ability to suspend and reinstate other users' accounts. This functionality is useful for dealing with harassment, cyberbullying, and other forms of abuse. Password Changes ~~~~~~~~~~~~~~~~ In the event of a data breach, administrators can update a user's password to a random string. The user can then log in using this temporary password and change. This functionality is also useful in the case that a user forgets their password. Promoting and Demoting Users ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Admins can grant and revoke admin privileges for other users. Creating an Admin Account ~~~~~~~~~~~~~~~~~~~~~~~~~ To create a new admin account, run the following command:: ./manage.py createadmin [--name | -n] [--password | -p] (TODO what working directory?) Resetting the Database ~~~~~~~~~~~~~~~~~~~~~~ TODO Troubleshooting --------------- TODO Known Issues ------------ For an up-to-date list of open issues, please see the `Lokole project's issue tracker `_.