- Show a notification 60 days, 30 days, 1 week, and 1 day before distribution upgrade. If a notification is dismissed for any of these periods don't show again until new period starts. Override any previous notification. - Show a notification just before the distribution upgrade showing that the process has started. Override any previous notification. - Show a notification after the distribution upgrade is completed that it is done. Override any previous notification. Keep this until it is 60 days before next distribution upgrade. If user dismisses the notification, don't show it again. Tests: - Start a bookworm VM. - Disable the auto updates. Set the date to 2025-08-01. Start the service. Notification is not shown when distribution check is done. Enable auto updates. - Set the date to 2025-07-01. Start the service. No notification is shown after distribution upgrade check is run. - Set the date to 2025-08-01. Start the service. Notification is shown when distribution check is done. Clicking on the 'Go to Distribution Update' takes to distribution update page. - Set the date to 2025-08-02. Start the service. Notification is not updated when distribution check is done. Dismiss the notification. - Set the date to 2025-08-03. Start the service. Notification is not shown when distribution check is done. - Set the date to 2025-08-22. Start the service. Notification is shown when distribution check is done. Dismiss the notification. - Set the date to 2025-08-23. Start the service. Notification is not shown when distribution check is done. - Set the date to 2025-09-15. Start the service. Notification is shown when distribution check is done. - Set the date to 2025-09-18 18:00. Start the service. Notification is shown when distribution check is done. - Set the date to 2025-09-19 18:00. Start the service. Notification is shown that distribution update has started. Distribution upgrade has started. Dismiss this notification. Upgrade does not succeed to due timestamp miss matches with release file. - Once the distribution upgrade has started. Start the service. Notification is not shown when distribution check is done. - Rollback to a snapshot before distribution upgrade. Start the distribution upgrade manually and notice that notification is not shown when distribution check is done. - Once the distribution upgrade has completed, start the service. Notification is shown the distribution upgrade has completed when distribution check is done. Dismiss this notification. - Restart the service. Notification is not shown when distribution check is done. 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.







