c47a856e3e
- This daemon will be faster than running actions using 'sudo' because the actions sometimes load all the modules before certain safety checks can be performed. The daemon will load just once for many privileged calls. Tests: - After daemon is started, systemd shows the status as 'activated'. - When daemon is started using socket activation and requests are sent, the requests succeed. - When daemon is started manually and requests are sent, the requests succeed. The socket file is created with root:root ownership and 0666 permissions. Parent directory is created if not exists. After the daemon exits, the socket file is removed. When daemon is started manually, automatic idle timeout exit does not happen. - According to journalctl, server exists after 5 seconds. Proper log message is seen. - Without development mode, server exists after 5 minutes of idle. Proper log message is seen. - When a sleep is added in one of the actions and when the action is running, server does not exit. Server exits after the request is completed. - When an error is raised in verify request, the server exits with proper error message. If the server exists with non-zero error code and is immediately restarted by systemd. - Sending a sample request using nc from root user and plinth user works. - Sending a sample request using nc from fbx user is rejected. - If a non-unicode text is sent as request, the response is a valid error dictionary. - If the request is larger than 1M, an 'request too large' error is thrown. Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org> Reviewed-by: Joseph Nuthalapati <njoseph@riseup.net>
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.