mirror of
https://github.com/freedombox/FreedomBox.git
synced 2026-01-21 07:55:00 +00:00
doc: Fetch latest manual
Signed-off-by: James Valleroy <jvalleroy@mailbox.org>
This commit is contained in:
James Valleroy
parent
e3f7511ff2
commit
eda492405a
@ -10,62 +10,20 @@
|
||||
|
||||
!FreedomBox includes the ability to backup and restore data, preferences, configuration and secrets from most of the applications. The Backups feature is built using Borg backup software. Borg is a deduplicating and compressing backup program. It is designed for efficient and secure backups. This backups feature can be used to selectively backup and restore data on an app-by-app basis. Backed up data can be stored on the !FreedomBox machine itself or on a remote server. Any remote server providing SSH access can be used as a backup storage repository for !FreedomBox backups. Data stored remotely may be encrypted and in such cases remote server cannot access your decrypted data.
|
||||
|
||||
=== Notes for Specific App Backups ===
|
||||
|
||||
=== Status of Backups Feature ===
|
||||
Unless otherwise noted here, backup of an app's data will include its configuration, secrets and other data.
|
||||
|
||||
|| '''App/Feature''' || '''Support in Version''' || '''Notes''' ||
|
||||
|| Avahi || - || no backup needed ||
|
||||
|| Backups || - || no backup needed ||
|
||||
|| bepasty || 20.14 || ||
|
||||
|| Bind || 0.41 || ||
|
||||
|| calibre || 20.15 || ||
|
||||
|| Cockpit || - || no backup needed ||
|
||||
|| Coturn || 20.8 || ||
|
||||
|| Datetime || 0.41 || ||
|
||||
|| Deluge || 0.41 || does not include downloaded/seeding files ||
|
||||
|| Diagnostics || - || no backup needed ||
|
||||
|| Dynamic DNS || 0.39 || ||
|
||||
|| ejabberd || 0.39 || includes all data and configuration ||
|
||||
|| Firewall || - || no backup needed ||
|
||||
|| Gitweb || 19.19 || ||
|
||||
|| I2P || 19.6 || ||
|
||||
|| ikiwiki || 0.39 || includes all wikis/blogs and their content ||
|
||||
|| infinoted || 0.39 || includes all data and keys ||
|
||||
|| JSXC || - || no backup needed ||
|
||||
|| Let's Encrypt || 0.42 || ||
|
||||
|| Matrix Synapse || 0.39 || includes media and uploads ||
|
||||
|| !MediaWiki || 0.39 || includes wiki pages and uploaded files ||
|
||||
|| Minetest || 0.39 || ||
|
||||
|| MiniDLNA || 19.23 || ||
|
||||
|| MLDonkey || 19.0 || ||
|
||||
|| Monkeysphere || 0.42 || ||
|
||||
|| Mumble || 0.40 || ||
|
||||
|| Names || - || no backup needed ||
|
||||
|| Networks || No || No plans currently to implement backup ||
|
||||
|| OpenVPN || 0.48 || includes all user and server keys ||
|
||||
|| Pagekite || 0.40 || ||
|
||||
|| Power || - || no backup needed ||
|
||||
|| Privoxy || - || no backup needed ||
|
||||
|| Quassel || 0.40 || includes users and logs ||
|
||||
|| Radicale || 0.39 || includes calendar and cards data for all users ||
|
||||
|| Roundcube || - || no backup needed ||
|
||||
|| Samba || 19.22 || does not include the data in the shared folders ||
|
||||
|| SearX || - || no backup needed ||
|
||||
|| Secure Shell (SSH) Server || 0.41 || includes host keys ||
|
||||
|| Security || 0.41 || ||
|
||||
|| Shadowsocks || 0.40 || only secrets ||
|
||||
|| Sharing || 0.40 || does not include the data in the shared folders ||
|
||||
|| Snapshot || 0.41 || only configuration, does not include snapshot data ||
|
||||
|| Storage || - || no backup needed ||
|
||||
|| Syncthing || 0.48 || does not include data in the shared folders ||
|
||||
|| Tahoe-LAFS || 0.42 || includes all data and configuration ||
|
||||
|| Tiny Tiny RSS || 19.2 || includes database containing feeds, stories, etc. ||
|
||||
|| Tor || 0.42 || includes configuration and secrets such as onion service keys ||
|
||||
|| Transmission || 0.40 || does not include downloaded/seeding files ||
|
||||
|| Upgrades || 0.42 || ||
|
||||
|| Users || No || No plans currently to implement backup ||
|
||||
|| Wordpress || 21.8 || ||
|
||||
|| Zoph || 21.3 || ||
|
||||
|| '''App/Feature''' || '''Notes''' ||
|
||||
|| [[FreedomBox/Manual/Deluge|Deluge]] || Does not include downloaded/seeding files ||
|
||||
|| [[FreedomBox/Manual/MiniDLNA|MiniDLNA]] || Does not include the data in the shared folders ||
|
||||
|| [[FreedomBox/Manual/Networks|Networks]] || No plans currently to implement backup ||
|
||||
|| [[FreedomBox/Manual/Samba|Samba]] || Does not include the data in the shared folders ||
|
||||
|| [[FreedomBox/Manual/Sharing|Sharing]] || Does not include the data in the shared folders ||
|
||||
|| Snapshot || Only configuration, does not include snapshot data ||
|
||||
|| [[FreedomBox/Manual/Syncthing|Syncthing]] || Does not include data in the shared folders ||
|
||||
|| [[FreedomBox/Manual/Transmission|Transmission]] || Does not include downloaded/seeding files ||
|
||||
|| [[FreedomBox/Manual/Users|Users]] || Backup of user accounts is [[https://salsa.debian.org/freedombox-team/freedombox/-/issues/2051|planned]] ||
|
||||
|
||||
=== How to install and use Backups ===
|
||||
|
||||
|
||||
@ -21,9 +21,6 @@ Only users who are members of the ''calibre'' group have access to the libraries
|
||||
|
||||
You might be familiar with the e-book reader shipped with the calibre application on your desktop. The server version of calibre that's installed on your !FreedomBox has a web-based e-book reader with similar look and feel. This allows you to read your e-books from any device with a web browser.
|
||||
|
||||
'''Note on calibre versions:'''
|
||||
Please note that depending on the Debian version your !FreedomBox is running, you might be running a different major version of calibre. Debian stable (Buster) has calibre 3.x, testing and unstable have calibre 5.x. This means that some of the experimental features like the web-based e-book reader might not work very well if you're on Debian stable. This situation will improve will the Debian 11 (Bullseye) release next year. !FreedomBox doesn't ship backported packages of calibre.
|
||||
|
||||
=== Managing Libraries ===
|
||||
|
||||
After installation of calibre, a default library called "Library" will be made available. The !FreedomBox administrator can add or delete any of the libraries including the default one from the app settings in !FreedomBox web interface.
|
||||
|
||||
@ -12,7 +12,7 @@
|
||||
== MLDonkey (Peer-to-peer File Sharing) ==
|
||||
||<tablestyle="float: right;"> {{attachment:MLDonkey-icon_en_V01.png|MLDonkey icon}} ||
|
||||
|
||||
'''Available since:''' version 0.48.0
|
||||
'''Availability:''' MLDonkey is not available in either Bullseye (stable) or Bookworm (testing).
|
||||
|
||||
=== What is MLDonkey? ===
|
||||
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
* !FreedomBox Service comes installed with all !FreedomBox images. You can [[FreedomBox/Download|download]] !FreedomBox images and run on any of the supported hardware. Then, to access !FreedomBox interface see [[FreedomBox/Manual/QuickStart|quick start]] instructions.
|
||||
|
||||
* If you are on a Debian box, you may install !FreedomBox Service from Debian package archive. Currently, only Buster (stable), Bullseye (testing), and Sid (unstable) are supported. To install !FreedomBox Service run:
|
||||
* If you are on a Debian box, you may install !FreedomBox Service from Debian package archive. Currently, only bullseye (stable), bookworm (testing), and sid (unstable) are supported. To install !FreedomBox Service run:
|
||||
|
||||
{{{
|
||||
$ sudo apt-get install freedombox
|
||||
|
||||
@ -139,46 +139,6 @@ file = /etc/radicale/rights
|
||||
==== Importing files ====
|
||||
If you are using a contacts file exported from another service or application, it should be copied to: /var/lib/radicale/collections/''user''/''contact file name''.vcf.
|
||||
|
||||
=== Migrating from Radicale Version 1.x to Version 2.x ===
|
||||
|
||||
During the month of February 2019, radicale in Debian testing was upgraded from version 1.x to version 2.x. Version 2.x is a better version but is incompatible with data and configuration used with 1.x. Automatic upgrade mechanism in !FreedomBox, handled by unattended-upgrades does not automatically upgrade radicale to version 2.x due to changes in configuration files. However, !FreedomBox version 19.1, which is available on February 23rd, 2019 in testing will perform data and configuration migration to radicale version 2.x. Typical users require no action, this will happen automatically.
|
||||
|
||||
If for some reason, you need to manually run `apt dist-upgrade` on your machine, then radicale will be upgraded to 2.x and then !FreedomBox will not be able to perform its upgrade (due to upstream project deciding to remove migration tools in radicale 2.x version). To avoid this situation, the following process is recommended if you wish to perform an upgrade.
|
||||
|
||||
{{{
|
||||
sudo su -
|
||||
apt hold radicale
|
||||
apt dist-upgrade
|
||||
apt unhold radicale
|
||||
}}}
|
||||
|
||||
However, if you already happen to perform an upgrade to radicale 2.x without help from !FreedomBox, you need to perform data and configuration migration yourself. Follow this procedure:
|
||||
|
||||
{{{
|
||||
sudo su -
|
||||
tar -cvzf /root/radicale_backup.tgz /var/lib/radicale/ /etc/radicale/ /etc/default/radicale
|
||||
apt install -y python-radicale
|
||||
python -m radicale --export-storage=/root/radicale-migration
|
||||
cp -dpR /root/radicale-migration/collection-root /var/lib/radicale/collections/collection-root/
|
||||
(remove this directory if it already exists. Or perhaps merge the contents.)
|
||||
chown -R radicale:radicale /var/lib/radicale/collections/collection-root/
|
||||
apt remove -y python-radicale
|
||||
if [ -f /etc/radicale/config.dpkg-dist ] ; then cp /etc/radicale/config.dpkg-dist /etc/radicale/config ; fi
|
||||
if [ -f /etc/default/radicale.dpkg-dist ] ; then cp /etc/default/radicale.dpkg-dist /etc/default/radicale ; fi
|
||||
(After FreedomBox 19.1 is available, goto FreedomBox web interface and set your preference for calendar sharing again, if it is not the default option, as it will have been lost.)
|
||||
}}}
|
||||
|
||||
Notes:
|
||||
* python-radicale is an old package from radicale 1.x version that is still available in testing. This is a hack to use the `--export-storage` feature that is responsible for data migration. This feature is not available in radicale 2.x unfortunately.
|
||||
* Files ending with .dpkg-dist will exist only if you have chosen 'Keep your currently-installed version' when prompted for configuration file override during radicale 2.x upgrade. The above process will overwrite the old configuration with new fresh configuration. No changes are necessary to the two configuration files unless you have changed the setting for sharing calendars.
|
||||
* Note that during the migration, your data is safe in /var/lib/radicale/collections directory. New data will be created and used in /var/lib/radicale/collections/collections-root/ directory.
|
||||
* The tar command takes a backup your configuration and data in /root/radicale_backup.tgz in case you do something goes wrong and you want to undo the changes.
|
||||
|
||||
=== Troubleshooting ===
|
||||
|
||||
1. If you are using !FreedomBox Pioneer Edition or installing !FreedomBox on Debian Buster, then radicale may not be usable immediately after installation. This is due to a bug which has been fixed later. To overcome the problem, upgrade !FreedomBox by clicking on 'Manual Update' from 'Updates' app. Otherwise, simply wait a day or two and let !FreedomBox upgrade itself. After that install radicale. If radicale is already installed, disable and re-enable it after the update is completed. This will fix the problem and get radicale working properly.
|
||||
|
||||
|
||||
=== External links ===
|
||||
|
||||
* Website: https://radicale.org/3.0.html
|
||||
|
||||
@ -10,6 +10,27 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f
|
||||
|
||||
The following are the release notes for each !FreedomBox version.
|
||||
|
||||
== FreedomBox 21.13 (2021-11-08) ==
|
||||
|
||||
=== Highlights ===
|
||||
|
||||
* avahi, samba: Use systemd sandboxing
|
||||
* components: Introduce new component - Packages
|
||||
* security: Properly handle sandbox analysis of timer units
|
||||
|
||||
=== Other Changes ===
|
||||
|
||||
* email_server (not enabled yet):
|
||||
* Add buttons for managing aliases, domains, spam
|
||||
* Authenticate using PAM instead of LDAP
|
||||
* Delivery mail to /var/mail instead of home directory
|
||||
* Don't use user IDs when performing lookups
|
||||
* Drop hash DB and use sqlite3 directly
|
||||
* Use Django forms and views
|
||||
* locale: Update translations for German, Swedish, Turkish, Ukrainian
|
||||
* tests: Use !BaseAppTests for functional tests of most apps
|
||||
* utils: Fix ruamel.yaml deprecation warnings
|
||||
|
||||
== FreedomBox 21.12 (2021-10-25) ==
|
||||
|
||||
* locale: Update translations for Bulgarian, Czech, French, German, Turkish, Ukrainian
|
||||
|
||||
@ -19,10 +19,7 @@
|
||||
|
||||
=== Installation ===
|
||||
|
||||
On [[DebianBuster]], wireguard is available from [[Backports]]. If your sources list contains the backports stanza, you can install wireguard from the Apps section of !FreedomBox web interface.
|
||||
{{{#!wiki caution
|
||||
WireGuard cannot be installed in !FreedomBox on buster-backports yet, because a newer version of NetworkManager is required by the !FreedomBox service to complete the setup.
|
||||
}}}
|
||||
You can install wireguard from the Apps section of the !FreedomBox web interface.
|
||||
|
||||
=== Configuration - Debian Peers ===
|
||||
|
||||
|
||||
@ -11,61 +11,19 @@
|
||||
!FreedomBox incluye la posibilidad de copiar y restaurar datos, preferencias, configuración y secretos de la mayoría de las aplicaciones. La funcionalidad de ''Backups'' se resuelve con el software de ''backup'' ''Borg''. ''Borg'' es un programa de ''backup'' con deduplicación y compresión. Está diseñado para hacer ''backups'' eficientes y seguros. Esta funcionalidad de ''backups'' se puede emplear para respaldar y recuperar datos aplicación por aplicación. Las copias de respaldado se pueden almacenar en la propia máquina !FreedomBox o en un servidor remoto. Cualquier servidor remoto con acceso por SSH se puede emplear como almacenamiento para los ''backups'' de la !FreedomBox. Las copias remotas se pueden cifrar para que el servidor remoto no pueda leer los datos que alberga.
|
||||
|
||||
|
||||
=== Estados de la Funcionalidad de Backups ===
|
||||
=== Notas para respaldos específicos ===
|
||||
Salvo que aquí se diga lo contrario, el respaldo de los datos de una aplicación incluirá su configuración, secretos y otros datos.
|
||||
|
||||
|| '''App/Funcionalidad''' || '''Soporte en Versión''' || '''Notas''' ||
|
||||
|| Avahi || - || no precisa ''backup'' ||
|
||||
|| Backups || - || no precisa ''backup'' ||
|
||||
|| bepasty || 20.14 || ||
|
||||
|| Bind || 0.41 || ||
|
||||
|| calibre || 20.15 || ||
|
||||
|| Cockpit || - || no precisa ''backup'' ||
|
||||
|| Coturn || 20.8 || ||
|
||||
|| Datetime || 0.41 || ||
|
||||
|| Deluge || 0.41 || '''no''' incluye archivos descargados ni semillas ||
|
||||
|| Diagnostics || - || no precisa ''backup'' ||
|
||||
|| Dynamic DNS || 0.39 || ||
|
||||
|| ejabberd || 0.39 || incluye todos los datos y configuración ||
|
||||
|| Firewall || - || no precisa ''backup'' ||
|
||||
|| Gitweb || 19.19 || ||
|
||||
|| I2P || 19.6 || ||
|
||||
|| ikiwiki || 0.39 || incluye todos los wikis/blogs y sus contenidos ||
|
||||
|| infinoted || 0.39 || incluye todos los datos y claves ||
|
||||
|| JSXC || - || no precisa ''backup'' ||
|
||||
|| Let's Encrypt || 0.42 || ||
|
||||
|| Matrix Synapse || 0.39 || incluye media y cargas ||
|
||||
|| !MediaWiki || 0.39 || incluye páginas de wiki y archivos adjuntos ||
|
||||
|| Minetest || 0.39 || ||
|
||||
|| MiniDLNA || 19.23 || ||
|
||||
|| MLDonkey || 19.0 || ||
|
||||
|| Monkeysphere || 0.42 || ||
|
||||
|| Mumble || 0.40 || ||
|
||||
|| Names || - || no precisa ''backup'' ||
|
||||
|| Networks || No || sin planes para implementar ''backup'', de momento ||
|
||||
|| OpenVPN || 0.48 || incluye a todos los usuarios y claves de servidor ||
|
||||
|| Pagekite || 0.40 || ||
|
||||
|| Power || - || no precisa ''backup'' ||
|
||||
|| Privoxy || - || no precisa ''backup'' ||
|
||||
|| Quassel || 0.40 || incluye usuarios y registros de ejeución (''logs'') ||
|
||||
|| Radicale || 0.39 || incluye calendario y datos de tarjetas de todos los usuarios ||
|
||||
|| Roundcube || - || no precisa ''backup'' ||
|
||||
|| Samba || 19.22 || ''no''' incluye datos de las carpetas compartidas ||
|
||||
|| SearX || - || no precisa ''backup'' ||
|
||||
|| Secure Shell (SSH) Server || 0.41 || incluye las claves del servidor ||
|
||||
|| Security || 0.41 || ||
|
||||
|| Shadowsocks || 0.40 || solo secretos ||
|
||||
|| Sharing || 0.40 || '''no''' incluye datos de las carpetas compartidas ||
|
||||
|| Snapshot || 0.41 || solo configuración, '''no''' incluye datos de capturas (snapshots) ||
|
||||
|| Storage || - || no precisa ''backup'' ||
|
||||
|| Syncthing || 0.48 || '''no''' incluye datos de las carpetas compartidas ||
|
||||
|| Tahoe-LAFS || 0.42 || incluye todos los datos y configuración ||
|
||||
|| Tiny Tiny RSS || 19.2 || incluye base de datos con ''feeds'', historias, etc. ||
|
||||
|| Tor || 0.42 || includes configuración y secretos como las claves de servicios Tor Onion ||
|
||||
|| Transmission || 0.40 || '''no''' incluye archivos descargados ni semillas ||
|
||||
|| Upgrades || 0.42 || ||
|
||||
|| Users || No || sin planes para implementar ''backup'', de momento ||
|
||||
|| Wordpress || 21.8 || ||
|
||||
|| Zoph || 21.3 || ||
|
||||
|| '''App/Funcionalidad''' || '''Notas''' ||
|
||||
|| [[es/FreedomBox/Manual/Deluge|Deluge]] || No incluye archivos descargados/sembrados ||
|
||||
|| [[es/FreedomBox/Manual/MiniDLNA|MinDLNA]] || No incluye los datos en carpetas compartidas ||
|
||||
|| [[es/FreedomBox/Manual/Networks|Redes]] || Actualmente no hay planes para implementar respaldos ||
|
||||
|| [[es/FreedomBox/Manual/Samba|Samba]] || No incluye los datos en carpetas compartidas ||
|
||||
|| [[es/FreedomBox/Manual/Sharing|Sharing]] || No incluye los datos en carpetas compartidas ||
|
||||
|| Instantáneas || Solo configuración, no incluye datos de instantánea ||
|
||||
|| [[es/FreedomBox/Manual/Syncthing|Syncthing]] || No incluye los datos en carpetas compartidas ||
|
||||
|| [[es/FreedomBox/Manual/Transmission|Transmission]] || No incluye archivos descargados/sembrados ||
|
||||
|| [[es/FreedomBox/Manual/Users|Usuarios]] || El respaldo de cuentas de usuario está [[https://salsa.debian.org/freedombox-team/freedombox/-/issues/2051|planificado]] ||
|
||||
|
||||
=== Cómo instalar y usar Backups ===
|
||||
|
||||
|
||||
@ -19,9 +19,6 @@ Sólo los usuarios del grupo ''calibre'' tienen acceso a las bibliotecas. Puedes
|
||||
|
||||
Quizá ya estés familiarizado con el lector de libros para escritorio que viene con Calibre. El servidor Calibre que se instala en tu !FreedomBox viene con un lector web con aspecto similar, lo que te permite leer tus libros desde cualquier dispositivo con navegador web.
|
||||
|
||||
'''Nota acerca de las versiones de Calibre:'''
|
||||
Dependiendo de la versión de Debian sobre la que se ejecuta tu !FreedomBox is running, tendrás una versión diferente de Calibre. Debian estable (Buster) lleva Calibre 3.x, ''en pruebas'' e ''inestable'' llevan Calibre 5.x. Esto implica que algunas funcionalidades experimentales como el lector web podrían no funcionar muy bien si estás en ''estable''. Esta situación mejorará el próximo año con la publicación de Debian 11 (Bullseye). Las actualizaciones frecuentes no abarcan a Calibre.
|
||||
|
||||
=== Administrar Bibliotecas ===
|
||||
|
||||
Tras la instalación, estará disponible una biblioteca inicial "Library". El administrador de !FreedomBox puede añadir o eliminar cualquier biblioteca incluyendo la inicial desde los ajustes de la app en el interfaz web de !FreedomBox.
|
||||
|
||||
@ -10,8 +10,7 @@
|
||||
== MLDonkey (Compartir archivos entre pares) ==
|
||||
||<tablestyle="float: right;"> {{attachment:FreedomBox/Manual/MLDonkey/MLDonkey-icon_en_V01.png|icono de MLDonkey}} ||
|
||||
|
||||
'''Disponible desde:''' versión 0.48.0
|
||||
|
||||
'''Disponible desde:''' versión 0.48.0, pero ya no está disponible ni en Bullseye (estable) ni en Bookworm (en pruebas).
|
||||
=== ¿Qué es MLDonkey? ===
|
||||
|
||||
''MLDonkey'' es una aplicación libre y multiprotocolo para compartir archivos entre pares (P2P) que ejecuta un servidor ''back-end'' sobre muchas plataformas. Se puede controlar mediante algún interfaz ''front-end'', ya sea web, telnet o cualquier otro de entre una docena de programas cliente nativos.
|
||||
|
||||
@ -6,9 +6,9 @@ El servicio !FreedomBox es [[https://www.gnu.org/philosophy/|Software Libre]] ba
|
||||
|
||||
=== Uso ===
|
||||
|
||||
* El servicio !FreedomBox viene instalado en todas las imágenes de !FreedomBox. Puedes [[FreedomBox/Download|descargar]] imágenes de !FreedomBox y ejecutarlas en cualquier hardware soportado. El servicio !FreedomBox (Plinth) estará accesible visitando la URL [[http://freedombox/plinth]] o [[https://freedombox.local/plinth]].
|
||||
* El servicio !FreedomBox viene instalado en todas las imágenes de !FreedomBox. Puedes [[FreedomBox/Download|descargar]] imágenes de !FreedomBox y ejecutarlas en cualquier hardware soportado. Para acceder al interfaz de !FreedomBox consulta [[es/FreedomBox/Manual/QuickStart|Guía rápida]].
|
||||
|
||||
* Si estás en una máquina Debian puedes instalar el servicio !FreedomBox desde el archivo de paquetes de Debian. Actualmente solo se soportan Buster (estable), Bullseye (en pruebas) y Sid (inestable). Para instalar el servicio !FreedomBox ejecuta:
|
||||
* Si estás en una máquina Debian puedes instalar el servicio !FreedomBox desde el archivo de paquetes de Debian. Actualmente solo se soportan Bullseye (estable), Bookworm (en pruebas) y Sid (inestable). Para instalar el servicio !FreedomBox ejecuta:
|
||||
|
||||
{{{
|
||||
$ sudo apt-get install freedombox
|
||||
|
||||
@ -137,45 +137,6 @@ file = /etc/radicale/rights
|
||||
==== Importar archivos ====
|
||||
Si estás usando un archivo de contactos exportado desde otro servicio o aplicación hay que copiarlo a: /var/lib/radicale/collections/<usuario>/<nombre_del_archivo_de_contactos>'.vcf.
|
||||
|
||||
=== Migrar desde Radicale versión 1.x a versión 2.x ===
|
||||
|
||||
En Febrero de 2019 se actualizó Radicale en las versiones "en pruebas" (testing) de Debian desde la versión 1.x a la 2.x. La versión 2.x es mejor pero incompatible con los datos y la configuración empleados en la 1.x. El mecanismo automático de actualización de !FreedomBox que emplean las actualizaciones desatendidas no actualiza automaticamente la version 2.x de Radicale debido a cambios en los archivos de configuración. No obstante la version 19.1 de !FreedomBox, disponible en en las versiones "en pruebas" (testing) desde el 23 de Febrero de 2019, realizará la migración de los datos y la configuración a la versión 2.x de Radicale. No se requiere ninguna acción por parte de los usuarios típicos. Ocurrirá automáticamente.
|
||||
|
||||
Si por algún motivo necesitas ejecutar a mano `apt dist-upgrade` en tu máquina Radicale se actualizará a 2.x y entonces tu !FreedomBox no podrá ejecutar esta actualización (ya que el proyecto de origen decidió eliminar las herramientas de migración de la versión 2.x de Radicale). Para evitar esta situación se recomienda el siguiente procedimiento para actualizar.
|
||||
|
||||
{{{
|
||||
sudo su -
|
||||
apt hold radicale
|
||||
apt dist-upgrade
|
||||
apt unhold radicale
|
||||
}}}
|
||||
|
||||
En cualquier caso, si ya has actualizado a Radicale 2.x sin ayuda de !FreedomBox necesitas realizar la migración de los datos y la configuración por tí mismo. Sigue este procedimiento:
|
||||
|
||||
{{{
|
||||
sudo su -
|
||||
tar -cvzf /root/radicale_backup.tgz /var/lib/radicale/ /etc/radicale/ /etc/default/radicale
|
||||
apt install -y python-radicale
|
||||
python -m radicale --export-storage=/root/radicale-migration
|
||||
cp -dpR /root/radicale-migration/collection-root /var/lib/radicale/collections/collection-root/
|
||||
(elimina este directorio si ya existe. O mezcla los contenidos.)
|
||||
chown -R radicale:radicale /var/lib/radicale/collections/collection-root/
|
||||
apt remove -y python-radicale
|
||||
if [ -f /etc/radicale/config.dpkg-dist ] ; then cp /etc/radicale/config.dpkg-dist /etc/radicale/config ; fi
|
||||
if [ -f /etc/default/radicale.dpkg-dist ] ; then cp /etc/default/radicale.dpkg-dist /etc/default/radicale ; fi
|
||||
(Cuando FreedomBox 19.1 está disponble ve al interfaz web de FreedomBox y vuelve a configurar tu preferencia de compartición de calendario si no se muestra bien porque se habrá perdido durante la operación.)
|
||||
}}}
|
||||
|
||||
Notas:
|
||||
* `python-radicale` es un paquete antigüo de la versión 1.x de Radicale que sigue disponible en las versiones "en pruebas" (testing) de Debian. Esto es un ''hack'' alternativo para emplear la funcionalidad `--export-storage` que es responsable de la migración de datos. Por desgracia esta funcionalidad ya no está disponible en Radicale 2.x.
|
||||
* Los ficheros que acaban en `.dpkg-dist` solo existirán si has elegido "Conservar tu versión actualmente instalada" cuando se te preguntó durante la actualización a Radicale 2.x. El procedimiento anterior sobrescribirá la configuración antigüa con una nueva. No se necesitan cambios a los 2 ficheros de configuración salvo que hayas cambiado la preferencia de compartición de calendario.
|
||||
* Nota: Durante la migración tus datos permanecen a salvo en el directorio `/var/lib/radicale/collections`. Los datos nuevos se crearán y usarán en el directorio `/var/lib/radicale/collections/collections-root/`.
|
||||
* El comando `tar` hace una copia de seguridad de tu configuración y tus datos en `/root/radicale_backup.tgz` por si haces o algo va mal y quieres deshacer los cambios.
|
||||
|
||||
=== Resolución de Problemas ===
|
||||
|
||||
1. Si estás usando !FreedomBox Pioneer Edition o instalando !FreedomBox sobre Debian Buster Radicale podría no estar operativo inmediatamente después de la instalación. Esto se debe a un defecto ya corregido posteriormente. Para superar el problema actualiza !FreedomBox haciendo clic en 'Actualización Manual' desde la app 'Actualizaciones'. Otra opción es simplemente esperar un par de días y dejar que !FreedomBox se actualice solo. Después instala Radicale. Si Radicale ya está instalado deshabilitalo y rehabilitalo después de que se complete la actualización. Esto arreglará el problema y dejará a Radicale trabajando correctamente.
|
||||
|
||||
|
||||
=== Enlaces externos ===
|
||||
|
||||
|
||||
@ -10,6 +10,27 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f
|
||||
|
||||
The following are the release notes for each !FreedomBox version.
|
||||
|
||||
== FreedomBox 21.13 (2021-11-08) ==
|
||||
|
||||
=== Highlights ===
|
||||
|
||||
* avahi, samba: Use systemd sandboxing
|
||||
* components: Introduce new component - Packages
|
||||
* security: Properly handle sandbox analysis of timer units
|
||||
|
||||
=== Other Changes ===
|
||||
|
||||
* email_server (not enabled yet):
|
||||
* Add buttons for managing aliases, domains, spam
|
||||
* Authenticate using PAM instead of LDAP
|
||||
* Delivery mail to /var/mail instead of home directory
|
||||
* Don't use user IDs when performing lookups
|
||||
* Drop hash DB and use sqlite3 directly
|
||||
* Use Django forms and views
|
||||
* locale: Update translations for German, Swedish, Turkish, Ukrainian
|
||||
* tests: Use !BaseAppTests for functional tests of most apps
|
||||
* utils: Fix ruamel.yaml deprecation warnings
|
||||
|
||||
== FreedomBox 21.12 (2021-10-25) ==
|
||||
|
||||
* locale: Update translations for Bulgarian, Czech, French, German, Turkish, Ukrainian
|
||||
|
||||
@ -16,10 +16,7 @@
|
||||
|
||||
=== Instalación ===
|
||||
|
||||
En está disponible para [[DebianBuster]] en [[Backports]]. Si tu lista de fuentes incluye a backports, Puedes instalar wireguard desde la sección Apps del interfaz web de !FreedomBox.
|
||||
{{{#!wiki caution
|
||||
WireGuard no se puede instalar aún en !FreedomBox con buster-backports porque el servicio !FreedomBox necesita una nueva versión de NetworkManager para ponerla en funcionamiento.
|
||||
}}}
|
||||
Puedes instalar !WireGuard desde la sección ''Apps'' de la interfaz de !FreedomBox.
|
||||
|
||||
=== Configuración - Debian Peers ===
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user