diff --git a/doc/manual/en/Debian.raw.wiki b/doc/manual/en/Debian.raw.wiki index c8042ace5..f2514d2ed 100644 --- a/doc/manual/en/Debian.raw.wiki +++ b/doc/manual/en/Debian.raw.wiki @@ -13,7 +13,7 @@ !FreedomBox is a [[DebianPureBlends|pure blend]] of Debian. This means that all the work on !FreedomBox is available in Debian as packages. It also means that any machine running Debian can be turned into a !FreedomBox. -This page describes the process of installing !FreedomBox on a Debian system. Currently, !FreedomBox works in Debian Stable (bookworm), Testing (trixie), and Unstable (sid). +This page describes the process of installing !FreedomBox on a Debian system. Currently, !FreedomBox works in Debian Stable (trixie), Testing (forky), and Unstable (sid). '''Important:''' Read [[FreedomBox/Hardware|general advice]] about hardware before building a !FreedomBox with this approach. @@ -21,13 +21,15 @@ This page describes the process of installing !FreedomBox on a Debian system. Cu '''Use a fresh Debian installation''' Installing !FreedomBox changes your Debian system in many important ways. This includes installing a firewall and regenerating server certificates. It is hence recommended that you install !FreedomBox on a fresh Debian installation instead of an existing setup. + +During installation of Debian, it is recommended that you choose btrfs as the filesystem for the root partition. Btrfs filesystem is needed for the Snapshots feature to work. }}} -=== Installing on Debian 12 (bookworm) or newer === +=== Installing on Debian 13 (trixie) or newer === Check the Troubleshooting section below, for any tips or workarounds that might help during the install. - 1. [[InstallingDebianOn|Install Debian]] 12 (Bookworm) or newer on your hardware. During installation choosing "Btrfs" for root filesystem type is recommended as !FreedomBox uses it take regular snapshots of the system. + 1. [[InstallingDebianOn|Install Debian]] 13 (Trixie) or newer on your hardware. During installation choosing "Btrfs" for root filesystem type is recommended as !FreedomBox uses it take regular snapshots of the system. 1. Update your package list. @@ -47,6 +49,16 @@ $ sudo DEBIAN_FRONTEND=noninteractive apt-get install freedombox 1. You can start [[FreedomBox/Manual/QuickStart|using]] !FreedomBox. During initial wizard, you will need to enter the secret noted above. +=== Difference between Debian Package and Disk Image === + +Following are the differences between setup using a !FreedomBox image vs. installing !FreedomBox using a Debian package on an existing Debian installation: + + 1. '''Filesystem:''' The disk images have btrfs as the filesystem. When installing a Debian package, the existing filesystem is not altered. The snapshots feature is currently only available if btrfs is the filesystem. So, for those wanting to install freedombox .deb package, it is recommended that they install Debian on a btrfs filesystem first. + + 1. '''First Wizard:''' When installing from a Debian package, !FreedomBox will ask for a secret (stored at a path on the disk) during first wizard. The secret is for security and has no relevance after the first wizard is completed. This secret is not asked if first wizard is run from a disk image (as hardware is expected to be in possession of the user and the user won't be able to easily peak the secret on the disk without running the first wizard first). + + 1. '''Networking:''' When disk image is booted, all the Ethernet and Wi-Fi devices are automatically configured to be managed by Network Manager. When !FreedomBox is installed from Debian package, existing network connections are not reconfigured. These network interfaces can later be reconfigured (by commenting out entries in /etc/network/interfaces) to be managed by Network Manager. + === Tips and Troubleshooting === 1. !FreedomBox uses !NetworkManager to manage network configuration. If you have configured your network interfaces using Debian installer or by editing `/etc/network/interfaces`, !FreedomBox will not manage those interfaces. (See [[https://bugs.debian.org/797614|bug #797614]].) To let !FreedomBox/NetworkManager manage your network interfaces, edit the `/etc/network/interfaces` manually and ensure that it contains only the following: diff --git a/doc/manual/en/ReleaseNotes.raw.wiki b/doc/manual/en/ReleaseNotes.raw.wiki index fa1092d55..0029c42b0 100644 --- a/doc/manual/en/ReleaseNotes.raw.wiki +++ b/doc/manual/en/ReleaseNotes.raw.wiki @@ -8,6 +8,38 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f The following are the release notes for each !FreedomBox version. +== FreedomBox 26.12 (2026-09-14) == + +=== Highlights === + + * locale: Add Lao translation + * radicale: Redirect from .well-known URLs only temporarily + * wireguard: Fix auto-adding client when no domains are configured + * wireguard: Fix issues with newline in public key when adding client + +=== Other Changes === + + * *: Additional import path related changes + * *: All other changes need for new import path + * *: Miscellaneous changes to work with reduce the use of term 'plinth' + * *: Update additional documentation/comments with new import path + * *: Update import path in modules-enabled configuration files + * *: Update imports statements from plinth to freedombox + * bin: Rename main binary from plinth to freedombox + * container: Fix failure with defining a new VM + * d/copyright: Update copyright file + * django: Changes for new import path + * django: Rename DB tables from plinth_ to freedombox_ + * doc/dev: Update developer documentation with new import path + * errors: Rename !PlinthError to !FbxError + * locale: Move lo to freedombox path + * locale: Update translations for Czech, French, Lao, Swedish + * nextcloud: test: Fix functional tests with version 26 + * plinth/*: Rename plinth/ folder to freedombox/ + * radicale: tests: Don't fail if Nextcloud is enabled + * tags: tests: Fix functional tests broken by separate apps/add page + * wireguard: Improve reliability functional tests by waiting after ops + == FreedomBox 26.11.1 (2026-08-19) == * apache: Stop installing uwsgi by default diff --git a/doc/manual/es/Debian.raw.wiki b/doc/manual/es/Debian.raw.wiki index c8042ace5..f2514d2ed 100644 --- a/doc/manual/es/Debian.raw.wiki +++ b/doc/manual/es/Debian.raw.wiki @@ -13,7 +13,7 @@ !FreedomBox is a [[DebianPureBlends|pure blend]] of Debian. This means that all the work on !FreedomBox is available in Debian as packages. It also means that any machine running Debian can be turned into a !FreedomBox. -This page describes the process of installing !FreedomBox on a Debian system. Currently, !FreedomBox works in Debian Stable (bookworm), Testing (trixie), and Unstable (sid). +This page describes the process of installing !FreedomBox on a Debian system. Currently, !FreedomBox works in Debian Stable (trixie), Testing (forky), and Unstable (sid). '''Important:''' Read [[FreedomBox/Hardware|general advice]] about hardware before building a !FreedomBox with this approach. @@ -21,13 +21,15 @@ This page describes the process of installing !FreedomBox on a Debian system. Cu '''Use a fresh Debian installation''' Installing !FreedomBox changes your Debian system in many important ways. This includes installing a firewall and regenerating server certificates. It is hence recommended that you install !FreedomBox on a fresh Debian installation instead of an existing setup. + +During installation of Debian, it is recommended that you choose btrfs as the filesystem for the root partition. Btrfs filesystem is needed for the Snapshots feature to work. }}} -=== Installing on Debian 12 (bookworm) or newer === +=== Installing on Debian 13 (trixie) or newer === Check the Troubleshooting section below, for any tips or workarounds that might help during the install. - 1. [[InstallingDebianOn|Install Debian]] 12 (Bookworm) or newer on your hardware. During installation choosing "Btrfs" for root filesystem type is recommended as !FreedomBox uses it take regular snapshots of the system. + 1. [[InstallingDebianOn|Install Debian]] 13 (Trixie) or newer on your hardware. During installation choosing "Btrfs" for root filesystem type is recommended as !FreedomBox uses it take regular snapshots of the system. 1. Update your package list. @@ -47,6 +49,16 @@ $ sudo DEBIAN_FRONTEND=noninteractive apt-get install freedombox 1. You can start [[FreedomBox/Manual/QuickStart|using]] !FreedomBox. During initial wizard, you will need to enter the secret noted above. +=== Difference between Debian Package and Disk Image === + +Following are the differences between setup using a !FreedomBox image vs. installing !FreedomBox using a Debian package on an existing Debian installation: + + 1. '''Filesystem:''' The disk images have btrfs as the filesystem. When installing a Debian package, the existing filesystem is not altered. The snapshots feature is currently only available if btrfs is the filesystem. So, for those wanting to install freedombox .deb package, it is recommended that they install Debian on a btrfs filesystem first. + + 1. '''First Wizard:''' When installing from a Debian package, !FreedomBox will ask for a secret (stored at a path on the disk) during first wizard. The secret is for security and has no relevance after the first wizard is completed. This secret is not asked if first wizard is run from a disk image (as hardware is expected to be in possession of the user and the user won't be able to easily peak the secret on the disk without running the first wizard first). + + 1. '''Networking:''' When disk image is booted, all the Ethernet and Wi-Fi devices are automatically configured to be managed by Network Manager. When !FreedomBox is installed from Debian package, existing network connections are not reconfigured. These network interfaces can later be reconfigured (by commenting out entries in /etc/network/interfaces) to be managed by Network Manager. + === Tips and Troubleshooting === 1. !FreedomBox uses !NetworkManager to manage network configuration. If you have configured your network interfaces using Debian installer or by editing `/etc/network/interfaces`, !FreedomBox will not manage those interfaces. (See [[https://bugs.debian.org/797614|bug #797614]].) To let !FreedomBox/NetworkManager manage your network interfaces, edit the `/etc/network/interfaces` manually and ensure that it contains only the following: diff --git a/doc/manual/es/ReleaseNotes.raw.wiki b/doc/manual/es/ReleaseNotes.raw.wiki index fa1092d55..0029c42b0 100644 --- a/doc/manual/es/ReleaseNotes.raw.wiki +++ b/doc/manual/es/ReleaseNotes.raw.wiki @@ -8,6 +8,38 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f The following are the release notes for each !FreedomBox version. +== FreedomBox 26.12 (2026-09-14) == + +=== Highlights === + + * locale: Add Lao translation + * radicale: Redirect from .well-known URLs only temporarily + * wireguard: Fix auto-adding client when no domains are configured + * wireguard: Fix issues with newline in public key when adding client + +=== Other Changes === + + * *: Additional import path related changes + * *: All other changes need for new import path + * *: Miscellaneous changes to work with reduce the use of term 'plinth' + * *: Update additional documentation/comments with new import path + * *: Update import path in modules-enabled configuration files + * *: Update imports statements from plinth to freedombox + * bin: Rename main binary from plinth to freedombox + * container: Fix failure with defining a new VM + * d/copyright: Update copyright file + * django: Changes for new import path + * django: Rename DB tables from plinth_ to freedombox_ + * doc/dev: Update developer documentation with new import path + * errors: Rename !PlinthError to !FbxError + * locale: Move lo to freedombox path + * locale: Update translations for Czech, French, Lao, Swedish + * nextcloud: test: Fix functional tests with version 26 + * plinth/*: Rename plinth/ folder to freedombox/ + * radicale: tests: Don't fail if Nextcloud is enabled + * tags: tests: Fix functional tests broken by separate apps/add page + * wireguard: Improve reliability functional tests by waiting after ops + == FreedomBox 26.11.1 (2026-08-19) == * apache: Stop installing uwsgi by default diff --git a/doc/manual/es/WordPress.raw.wiki b/doc/manual/es/WordPress.raw.wiki index 0dde14c0b..4c1f3d934 100644 --- a/doc/manual/es/WordPress.raw.wiki +++ b/doc/manual/es/WordPress.raw.wiki @@ -51,7 +51,9 @@ Por omisión las direcciones web de artículos de blog de nueva creación son co === Actualizaciones automáticas === -Como con todas las demás apps, !FreedomBox (si no se deshabilitan) maneja las actualizaciones funcionales y de seguridad para !WordPress automáticamente. Tras una actualización de versión menor !WordPress efectúa automáticamente cambios en la estructura de la base de datos. No obstante, tras una actualización de versión mayor como un salto bianual de distribución los cambios en la base de datos no son automáticos. Para esto necesitarás ingresar a !WordPress y dispararlos manualmente. +Como con todas las demás apps, !FreedomBox (mientras permanezca habilitada la funcionalidad de autoactualización) maneja las actualizaciones funcionales y de seguridad para !WordPress automáticamente. Nótese que el actualizador propio de !WordPress no puede actualizar el núcleo de !WordPress ni plugins que se instalen desde paquetes Debian. Solo se puede usar para actualizar plugins adicionales añadidos a la instalación. + +Tras una actualización de versión menor !WordPress efectúa automáticamente cambios en la estructura de la base de datos. No obstante, tras una actualización de versión mayor como un salto bianual de distribución los cambios en la base de datos no son automáticos. Para esto necesitarás ingresar a !WordPress y dispararlos manualmente. === Plugins y Temas ===