b7df34d175
Tests: - On stable, testing distributions applying the patches and restarting the services causes two files to be created on the system. /etc/apt/sources.list.d/freedombox-unstable.list and /etc/apt/preferences.d/50freedombox-dist.pref. In unstable distributions the files are not created. - Installing Matrix Synapse on all three distributions works. Initial domain configuration works. All diagnostic tests pass. - On stable and testing distributions, running 'apt policy matrix-synapse' shows that priority for package from unstable is 200 higher than installed package priority of 100. Same for the package python3-pympler. Running 'apt policy freedombox' shows that package from -backports has a priority of 500 that is same as the priority of non-backports package. Tests: - During re-run of setup, unstable sources are setup. - Matrix synapse app shows updated description. - Upgrades app shows updated description about frequent feature updates. - On oldstable, stable, and testing distributions unstable sources are setup. But not on unstable. - On stable, testing distributions applying the patches and restarting the services causes two files to be created on the system. /etc/apt/sources.list.d/freedombox-unstable.list and /etc/apt/preferences.d/50freedombox-unstable.pref. In unstable distributions the files are not created. - Installing Matrix Synapse on all four distributions works. Initial domain configuration works. All diagnostic tests pass. - On oldstable, stable, and testing distributions, running 'apt policy python3-pympler matrix-synapse python3-python-multipart' shows that priority for package from unstable is 200 higher than installed package priority of 100. Running 'apt policy freedombox' shows that package from -backports has a priority of 500 that is same as the priority of non-backports package. - When frequent feature updates is not enabled, the app can't be installed. "This application is currently not available in your distribution." message is shown. After enabling frequent feature updates, the apps can be installed. 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
License
FreedomBox is distributed under the GNU Affero General Public License, Version 3 or later. A copy of AGPLv3 is available from the Free Software Foundation.