fd345aca80
- Secret is important for various functions of Django. There is no impact on existing installations due to the change. Improves the security of existing functions in minor ways and will be useful in future usage of Django. - Create the file in /var/lib/plinth/ with 0o600 permissions. - Make git ignore the file in code folder. - Don't copy the file during './setup.py install' operation. Impact to users after upgrade: - All existing sessions will get logged out. This is because SECRET_KEY is used to generate user session hash that is used to logout users when their password changes. Tests performed: - Run development version of service. File should get created in data/var/lib/plinth/django-secret.key. Permissions should be 0o600. - Run again, the file should not be overwritten. Printing django.conf.settings.SECRET_KEY should match the one in the file. - Run `setup.py install`. This should not install django-secret.key in /var/lib/plinth. - Run `sudo -u plinth plinth`. This should create the secret key file in /var/lib/plinth/django-secret.key. Permissions on the file should be 0o600. Ownership should be plinth:plinth. - Remove the file in both cases, a fresh new file should get created with new key. - Truncate the file to less than 128 chars, the existing file should get overwritten with new key. Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org> Reviewed-by: James Valleroy <jvalleroy@mailbox.org>
FreedomBox Service (Plinth)
The core functionality and web front-end of FreedomBox.
Description
FreedomBox is a community project to develop, design and promote personal servers running free software for private, personal communications. It is a networking appliance designed to allow interfacing with the rest of the Internet under conditions of protected privacy and data security. It hosts applications such as blog, wiki, website, social network, email, web proxy and a Tor relay, on a device that can replace your Wi-Fi router, so that your data stays with you.
This module, called FreedomBox Service and also know as Plinth, is the core functionality and web interface to the functions of the FreedomBox. It is extensible and provides various applications of FreedomBox as modules. Each module or application provides simplified user interface to control the underlying functionality. As FreedomBox can act as a wireless router, it is possible to configure networking. It also allows configuration of basic system parameters such as time zone, hostname and automatic upgrades.
You can find more information about FreedomBox Service (Plinth) on the Plinth Wiki page, the FreedomBox Wiki and the FreedomBox Manual.
Getting Started
To have a running FreedomBox, first install Debian (Buster or higher) on a clean machine. Then run:
$ sudo apt install freedombox
Full instructions are available on FreedomBox Manual's QuickStart page.
For instructions on running the service on a local machine from source code, see INSTALL.md. For instructions on setting up for development purposes, see HACKING.md.
Contributing
See the HACKING.md file for contributing to FreedomBox Service (Plinth).
Localization
