3af63bbf21
- Migration files have already been renamed from plinth/migrations/*.py to freedombox/migrations/*.py. When running these migrations, ensure that database tables are first created with plinth_* names rather than freedombox_*. This is because we want the database progression path for fresh installations (with not tables) as well as the old installation (with plinth_ tables) to be the same. To achieve this, migrations.CreateModel will be provided with db_table=plinth_* values. - Ensure if a migration call (plinth, 0001_initial) ran, then the (freedombox, 0001_initial) is not run again. This is achieved by adding replaces = [] in the newly renamed migration. - Create a new migration that renames plinth_* tables to freedombox_*. - Fix an old migration (0003) to use historic model rather than current model. This ensure that it uses the plinth_ table during migration rather than freedombox_ table. Tests: - Delete the database and start plinth.service with all the patches. Notice that the database migration (fresh creation) works well. First setup, first wizard, bepasty app installation, and notifications work as expected. Notice that django_migrations table contains entries for (plinth,000[1-6]*) as well as (freedombox,000[1-7]*). - Delete the database and start plinth.service without the patches. Run first setup and wizard. Install bepasty. Then apply the patches and restart plinth.service. Notice that the database migration (renaming of tables) works well. First setup is already done. First wizard is not shown. bepasty is shown as installed. Previously shown notifications are retained . Notice that django_migrations table contains entries for (plinth,000[1-6]*) as well as (freedombox,000[1-7]*). - Delete the database and start plinth.service from trixie version. Run first setup and wizard. Install bepasty. Then apply the patches and restart plinth.service. Notice that the database migration (renaming of tables) works well. First setup is already done. First wizard is not shown. bepasty is shown as installed. Previously shown notifications are retained . Notice that django_migrations table contains entries for (plinth,000[1-6]*) as well as (freedombox,000[1-7]*). 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.