fa57610b07
Closes: #2490 - When app update and force upgrade are pending on an app, app.setup() is run during initialization. During setup(), force upgrade is first run as expected. However, force upgrade does not do it's job when an app needs version upgrade. setup() then tries to run package install() for the app and fails because configuration file prompt is pending. Tests: - On a fresh bookworm container, update all packages. Run freedombox and ensure that first setup has been completed. Stop freedombox and increment the firewall app version. Then change sources.list and change bookworm to testing. Run apt update. Then start the fredombox service. Notice that firewall app setup is run. During the setup, force upgrader is executed. It install the newer firewall package with the newer configuration file and performs the configuration file changes. After that setup process continues and completes successfully. firewalld package has been upgraded from 1.3.x to 2.3.x. firewalld service is running. In /etc/firewalld/firewalld.conf default zone is set to external and backend is set to nftables. - Rerun the above test without the patches and notice that force upgrader does not recognize firewall as a package to upgrade and setup() fails when trying to install() packages. This is run in a loop continuously. 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.