diff --git a/doc/manual/en/A20-OLinuXino-Lime2.raw.wiki b/doc/manual/en/A20-OLinuXino-Lime2.raw.wiki index 6974528a6..f73b75aff 100644 --- a/doc/manual/en/A20-OLinuXino-Lime2.raw.wiki +++ b/doc/manual/en/A20-OLinuXino-Lime2.raw.wiki @@ -43,7 +43,7 @@ An alternative to downloading these images is to [[InstallingDebianOn/Allwinner| === Known Issues === - * Revision G2 (written on the board): The current stable Debian11/bullseye image (from 2021-08-27) '''will not start an Ethernet connection!''' This means you can not continue with the installation process at first. This can be fixed by following [[https://wiki.debian.org/InstallingDebianOn/Allwinner#Olimex_A20-OLinuXino-LIME2__rev._F_and_newer_and_Debian11.2F_bullseye_kernel | this description]] after you [[https://wiki.debian.org/FreedomBox/Download#Installation | copied the image to your SD card]]. Or you Download and use the [[https://ftp.freedombox.org/pub/freedombox/pioneer/|Pioneer Edition image]] to fix the issue. It contains a slightly [[https://salsa.debian.org/freedombox-team/u-boot/commit/2cb18893ef|modified u-boot]]. + * Revision G2 (written on the board): The current stable Debian11/bullseye image (from 2021-08-27) '''will not start an Ethernet connection!''' This means you can not continue with the installation process at first. This can be fixed by following [[https://wiki.debian.org/InstallingDebianOn/Allwinner#Olimex_A20-OLinuXino-LIME2__rev._F_and_newer_and_Debian11.2F_bullseye_kernel | this description]] after you [[https://wiki.debian.org/FreedomBox/Download#Installation | copied the image to your SD card]]. Or you Download and use the [[https://ftp.freedombox.org/pub/freedombox/hardware/pioneer/|Pioneer Edition image]] to fix the issue. It contains a slightly [[https://salsa.debian.org/freedombox-team/u-boot/commit/2cb18893ef|modified u-boot]]. * Revision G2 hardware has also [[DebianBug:927397|poor performance when transmitting Ethernet data in Gigabit mode]] for older FreedomBox releases. The procedure above or for rev. C fixes this. * Revision C hardware has [[DebianBug:845128|poor performance when receiving Ethernet data in Gigabit mode]]. To workaround the problem, you can switch to 100 Mbps mode instead of Gigabit mode. Login to your !FreedomBox as root (or plugin the SD card into another computer) and create the file /etc/NetworkManager/dispatcher.d/20-fix-ethernet-problem with the following contents: diff --git a/doc/manual/en/Cubieboard2.raw.wiki b/doc/manual/en/Cubieboard2.raw.wiki index aad8164d0..ee1b6cb19 100644 --- a/doc/manual/en/Cubieboard2.raw.wiki +++ b/doc/manual/en/Cubieboard2.raw.wiki @@ -37,4 +37,4 @@ The Cubieboard 2 is a single board computer based on the Allwinner A20 processor CategoryFreedomBox -Cubieboard 2 image is licensed under a Creative Commons Attribution-!ShareAlike 2.0 Generic License by [[https://www.flickr.com/photos/120586634@N05/14673300334/in/photolist-pMbdDm-omCuYN-o5kVMu-dy9jTD-dy99Kz|Flickr]]. +Cubieboard 2 image is licensed under the [[https://creativecommons.org/licenses/by-sa/2.0/|Creative Commons Attribution-Share Alike 2.0 Generic license]] by [[https://commons.wikimedia.org/wiki/File:Cubieboard_2_-_Top_(14673300334).jpg|Gareth Halfacree]]. diff --git a/doc/manual/en/Download.raw.wiki b/doc/manual/en/Download.raw.wiki index f6902c47d..0b83de43a 100644 --- a/doc/manual/en/Download.raw.wiki +++ b/doc/manual/en/Download.raw.wiki @@ -176,7 +176,7 @@ On MacOS (OSX) you can use programs like ''balenaetcher'' and ''rosaimagewriter' === From within FreedomBox === -!FreedomBox is made up of several software programs and you can obtain the source code to any of them. These instructions are similar to obtaining and [[https://www.debian.org/doc/manuals/maint-guide/build.en.html|building]] [[https://www.debian.org/doc/manuals/apt-howto/ch-sourcehandling.en.html|source code]] [[https://wiki.debian.org/BuildingTutorial|for Debian]] since !FreedomBox is a pure blend of Debian. Using this process you can obtain the source code to the exact version of the package you are currently using in !FreedomBox. +!FreedomBox is made up of several software programs and you can obtain the source code to any of them. These instructions are similar to obtaining and [[https://www.debian.org/doc/manuals/maint-guide/build.en.html|building]] [[https://wiki.debian.org/Packaging/SourcePackage#How_to_Download_a_source_package|source code]] [[https://wiki.debian.org/BuildingTutorial|for Debian]] since !FreedomBox is a pure blend of Debian. Using this process you can obtain the source code to the exact version of the package you are currently using in !FreedomBox. 1. To see the list of software packages installed on your !FreedomBox, run the following in a terminal: {{{ diff --git a/doc/manual/en/ExposeLocalService.raw.wiki b/doc/manual/en/ExposeLocalService.raw.wiki new file mode 100644 index 000000000..783563afe --- /dev/null +++ b/doc/manual/en/ExposeLocalService.raw.wiki @@ -0,0 +1,158 @@ +#language en + +##TAG:TRANSLATION-HEADER-START +~- [[FreedomBox/Guide/ExposeLocalService|English]] - [[es/FreedomBox/Guide/ExposeLocalService|Español]] - [[DebianWiki/EditorGuide#translation|(+)]] -~ +##TAG:TRANSLATION-HEADER-END + +<> + +## BEGIN_INCLUDE + +== Expose a Local Service to Internet using FreedomBox == + +This guide describes to expose a local service you have on your LAN to the internet using a !FreedomBox that is already exposed on the internet. + +=== Goal === + + * ''You have a !FreedomBox running'' with a working domain already setup. You are able to access your !FreedomBox using a URL such as `https://www.mysite.example/` . + * ''You have a different server running a local service'' on LAN that you wish to expose to the Internet on the same domain as your !FreedomBox. The local service must be a web service using the HTTP protocol (it is also possible to setup non-HTTP service, but that is a different approach). Optionally, you can have special domain assigned specifically for this local service. + * You wish for ''!FreedomBox to handle the TLS certificates'' for this domain as !FreedomBox typically does. Your local service need not setup and manage TLS certificates. + * Optionally, you may want to ''limit access to local service using !FreedomBox credentials''. Only users with a !FreedomBox account (and belonging to a chosen group) will be able to access this service. The local service will not be available to general public on the Internet. This way you can host local services that don’t implement their own authentication or local services with their own authentication mechanisms disabled. + +=== Exposing Local LAN servers === + + * To expose the service, create an Apache configuration file in `/etc/apache2/conf-available/` and write a `ProxyPass` directive. Assuming your local service is running on a computer with IP address `192.168.0.20` on port `3000`, you can do this by running a command (as a root user on the terminal): + + {{{#!highlight bash +cat > /etc/apache2/conf-available/my-local-service.conf < + Include includes/freedombox-single-sign-on.conf + + ProxyPass http://192.168.0.20:3000/ + +}}} + 1. Then, reload Apache web server. + {{{#!highlight bash +systemctl reload apache2 +}}} + +If you wish for only some groups of users to be able to access the service, another change to the configuration is needed. Make the configuration look like the following if you wish to allow users of “web-search” group and also users of “admin” group to access the local service. All other users even if they have a valid !FreedomBox account will be denied access. + +{{{#!highlight apache + + Include includes/freedombox-single-sign-on.conf + + + TKTAuthToken "web-search" "admin" + + + ProxyPass http://192.168.0.20:3000/ + +}}} + +=== Hosting the Service on a Separate Domain === + +Some services and web applications hosted under a URL fragment such as `/myservice/` do not work well. They require an entire domain or subdomain to be dedicated to them. In these cases too, !FreedomBox can expose local services. + + 1. First acquire a domain or a subdomain. + * If your domain is a custom domain that you own, go to the DNS settings on your domain name provider and add a subdomain. You can create a CNAME record that simply points to the main domain. + * If you are using !FreedomBox Dynamic DNS service, then login into https://ddns.freedombox.org and enable the “Wildcard” option. With this change, for a domain (such as `example.fbx.one`), all subdomains (such as `myservice.example.fbx.one`) of your domain will point to your main domain. + 1. Add the new domain into !FreedomBox. Goto System → Name Services → Domain (regular) → Add. For example, add `myservice.mysite.example`. + 1. Then create an Apache configuration file at `/etc/apache2/includes/-include.conf`. For our example this is: `/etc/apache2/includes/myservice.mysite.example-include.conf`. The contents of the file should be: + {{{#!highlight apache +ProxyPass / http://192.168.0.20:3000/ +}}} + 1. Modify the above file for authentication if necessary by adding the `Include` and `` configuration directives as shown in the authentication section above. + +=== Troubleshooting === + +When your setup does not work as expected, to debug, run a temporary web service on your !FreedomBox. + + 1. Create a temporary directory with an index.html page on the !FreedomBox. + {{{#!highlight bash +mkdir temp +cd temp +cat > index.html < + + + My test page + + +

Hello, World!

+ + +EOL +}}} + 1. Run a temporary web server (press Control-C to terminate): + {{{#!highlight bash +python3 -m http.server 3000 +}}} + 1. Update the Apache configuration to point to this temporary service on !FreedomBox. + {{{#!highlight apache +ProxyPass /myservice http://127.0.0.1:3000/ +}}} + +=== Extras === + +There are many additional features that Apache can provide to improve the local service. For these, [[https://httpd.apache.org/docs/current/|explore Apache documentation]]. Some features include: + + * Serving static files such as JS, CSS, and media files from local directory without invoking the local service to improve performance. + * Caching the responses from the local service to improve performance. + * Setting additional headers for security, cache control, etc. + * Modify the HTTP header responses from the service when it does not work well to hosting under a URL fragment such as `/myservice/`. + * Perform redirects from `http://` URL to `https://` and setting HSTS header. + * Load balancing among multiple local services for high availability, scaling, etc. + * And more. + + +## END_INCLUDE + +Back to [[FreedomBox/Features|Features introduction]] or [[FreedomBox/Manual|manual]] pages. + +<> + +---- +CategoryFreedomBox diff --git a/doc/manual/en/Kiwix.raw.wiki b/doc/manual/en/Kiwix.raw.wiki new file mode 100644 index 000000000..c8536410b --- /dev/null +++ b/doc/manual/en/Kiwix.raw.wiki @@ -0,0 +1,55 @@ +#language en +##TAG:TRANSLATION-HEADER-START +Translations ~- [[DebianWiki/EditorGuide#translation|(+)]] - [[FreedomBox/Manual/Kiwix|English]] - [[es/FreedomBox/Manual/Kiwix|Español]] -~ +##TAG:TRANSLATION-HEADER-END + +<> + +## BEGIN_INCLUDE +== Kiwix (Offline Wikipedia) == +'''Available since:''' version 23.19 +|| {{attachment:kiwix-tile.png|Kiwix icon}} || + +[[https://en.wikipedia.org/wiki/Kiwix|Kiwix]] can serve archives of websites offline. It was originally created to serve an offline version of Wikipedia, the free encyclopedia. + +=== Use Cases === + +[[https://en.wikibooks.org/wiki/FreedomBox_for_Communities|FreedomBox for Communities]] was already using Kiwix years before it was officially included as an app. Kiwix was used to serve content over community Wi-Fi networks in [[https://en.wikipedia.org/wiki/Gangadevipalli#Free_Community_WiFi|villages]] of India with unreliable or insufficient Internet access. In addition to an offline Wikipedia, Kiwix served + * the archive "Wikipedia for Schools" which was used by school teachers and students for homework assignments and as a teaching aid. + * the archive "!WikiSource (in Telugu)" which served as a digital library. + +Kiwix is also useful when you have reliable Internet access. + 1. Archival and preservation: Archives of websites can be created and preserved as ZIM files. These archives can be served using Kiwix. + 2. Fast access to slow websites: An offline archive can be faster to access than a website. + 3. Access to websites that can be temporarily unavailable. For example, the Low Tech Magazine is hosted on a solar-powered single-board computer and could go offline sometimes. There is a Kiwix archive available for it which can be hosted locally. + +=== Kiwix on FreedomBox === + +!FreedomBox serves the Debian package called kiwix-tools which allows managing and serving content archives in ZIM file format. ZIM files can be added or removed by a !FreedomBox administrator or any user in the "kiwix" user group. + +Kiwix on !FreedomBox is available via web interface only. There are mobile and desktop clients for Kiwix, but they can only read local archives. They cannot pull content from Kiwix hosted on !FreedomBox. + +The web interface of Kiwix is available for public access by default. + +=== Finding content archives === + +To find content for Kiwix, go to [[https://library.kiwix.org|library.kiwix.org]]. You can download archives (called "books") using direct download or using BitTorrent. The website itself is a Kiwix installation, so you can have a preview of the content before downloading, to check that the archive is not broken. + +An alternative source of the same files is [[https://wiki.kiwix.org/wiki/Main_Page|wiki.kiwix.org]], a wiki with download links and more information about the Kiwix project. + +=== Creating content archives === + +The [[https://openzim.org/|OpenZim]] project maintains tools to create ZIM files. The tool [[https://github.com/openzim/zimit|zimit]] is a complete solution that can scrape a website and create a ZIM file. You can also request a ZIM archive using the website [[https://youzim.it|youzim.it]]. + +=== External links === + * Upstream project: https://kiwix.org/ + * Upstream documentation: https://kiwix.org/frequently-asked-questions/ + +## END_INCLUDE + +Back to [[FreedomBox/Features|Features introduction]] or [[FreedomBox/Manual|manual]] pages. + +<> + +---- +CategoryFreedomBox diff --git a/doc/manual/en/QuickStart.raw.wiki b/doc/manual/en/QuickStart.raw.wiki index df5552d13..539705dc4 100644 --- a/doc/manual/en/QuickStart.raw.wiki +++ b/doc/manual/en/QuickStart.raw.wiki @@ -56,8 +56,7 @@ Alternatively you may choose to build it yourself, by gathering all the componen 1. On accessing !FreedomBox's web interface your browser will warn you that it communicates securely but that it regards the security certificate for doing so as invalid. This is a fact you need to accept because the certificate is auto generated on the box and therefore "self-signed" (the browser might also use words such as "untrusted", "not private", "privacy error" or "unknown issuer/authority"). Telling your browser that you are aware of this might involve pressing buttons such as "I understand the Risks", "proceed to ... (unsafe)" or "Add exception". After installation this certificate can be changed to a normal one using the Let's Encrypt option. - . {{attachment:ui_insecure_connection.png|Self-signed certificate warning|width=600}} - . {{attachment:ui_add_security_exception.png|Add Security Exception|width=400}} + . {{attachment:ui_insecure_connection.png|Self-signed certificate warning|width=500}} If the domain name you are using already has a valid certificate from a recognised Certificate Authority, such as from Let's Encrypt, you may not be able to access the web interface. This means that the option to continue will not be offered. This might occur, for example, if you are reinstalling your !FreedomBox or are otherwise reusing a domain name that has an associated certificate. @@ -74,8 +73,11 @@ Alternatively you may choose to build it yourself, by gathering all the componen 1. The next page asks you to provide a user name and password. Fill in the form, and then click "Create Account." * Note: The user that you create here has ``Admin`` privileges and can also [[FreedomBox/Manual/SecureShell|log in using ssh]]. For additional security, you may want to use a separate account for administrative tasks and for your normal, daily use. You can add more users later. . {{attachment:ui_firstboot_account.png|Account|width=500}} - 1. After completing the form, you will be logged in to !FreedomBox's web interface and able to access apps and configuration through the interface. + 1. After completing the form, you will be logged in to !FreedomBox's web interface and asked if you wish to receive more frequent updates (recommended). + . {{attachment:ui_firstboot_feature_updates.png|Feature Updates|width=500}} + 1. Setup is complete. Now you can examine and possibly update several key configuration items or see which apps are available. Until you dismiss them, notifications accessible from the menu bar will remind you to review the key configuration items. . {{attachment:ui_firstboot_complete.png|Complete|width=500}} + . {{attachment:ui_firstboot_complete_notification.png|Complete|width=500}} Now you can try [[FreedomBox/Features|any of the Apps]] that are available on !FreedomBox. @@ -93,7 +95,7 @@ The front page includes shortcuts to apps that have been installed and are enabl === Apps menu === -The Apps menu can be accessed by clicking the grid icon, next to the !FreedomBox logo. This page lists all of the apps that are available for installing on !FreedomBox. Click the name of an app to visit its page, where you can install and configure it. +The Apps menu can be accessed by clicking the grid icon, next to the !FreedomBox logo. This page lists all of the apps that are available for installing on !FreedomBox. Click the name of an app to visit its page, where you can install and configure it. Currently installed and enabled apps are shown above the remaining available apps. {{attachment:ui_apps.png|Apps|width=600}} diff --git a/doc/manual/en/ReleaseNotes.raw.wiki b/doc/manual/en/ReleaseNotes.raw.wiki index fdef425b2..ce93ff860 100644 --- a/doc/manual/en/ReleaseNotes.raw.wiki +++ b/doc/manual/en/ReleaseNotes.raw.wiki @@ -8,6 +8,98 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f The following are the release notes for each !FreedomBox version. +== FreedomBox 25.10 (2025-08-18) == + +=== Highlights === + + * email: Add full text search capability + * homeassistant: Add the most popular app for home automation + +=== Other Changes === + + * *: Update copyright year + * action_utils: Add support for device mappings in podman containers + * action_utils: Allow checking result for service operations + * actions: Add method to handle privileged JSON request to a server + * actions: Allow logging privileged calls to a server differently + * actions: Call to a privileged server if it is available + * actions: Raise a proper exception if privileged module is not found + * actions:privileged: Fix flake8 errors + * apache, letsencrypt: Create a site specific config for all domains + * apache: Add component to host an app on a site's root + * apache: Allow customization to the root of a site + * apache: Generalize TLS config to use certificates only if available + * apache: Make all directory listings more mobile friendly + * app: Don't load apps again + * apps: Fix regression in enabling install button + * config: Allow better Apache default home page + * container: Add component for managing containers using podman + * d/control: Drop dependency on python3-setuptools-git + * debian, pyproject.toml: Remove ancient python3-tomli workaround + * debian: Print warning if version mismatch + * diagnostics: Add collapsible sections for results + * doc: Update man page with option --version + * dovecot: Allow login using email address with dovecot version 2.4 + * dovecot: Fix location of Inbox in dovecot 2.4 + * dynamicdns: Add info about subdomains with Foundation's service + * dynamicdns: Fix a type check error + * dynamicdns: Switch update client to HTTP protocol + * email: Increment app version number to trigger dovecot restart + * featherwiki: Disable caching to avoid 412 errors + * featherwiki: Don't allow index.html as a file name + * forms: Allow showing a None option during domain selection + * letsencrypt: Drop old app migration code + * locale: Update translations for Catalan, Dutch, Estonian, Tamil + * Makefile: Developer setup for privileged daemon + * matrixsynapse: Drop help text for domain selection dropdown + * module_loader: Don't load modules again + * names: Add information about adding static domains/subdomains + * notifications: Add datetime to each notification + * notifications: Fix setting last_update_time + * notifications: Minor styling fix for operation notifications + * package: Refresh apt cache if old and some packages are not found + * package: Uninstall packages even if they are not in apt cache + * plinth: Add --version flag to print version and exit + * privileged: Add /bin file for privileged daemon + * privileged: Add systemd units for socket activating the daemon + * privileged: Introduce a UNIX socket daemon for privileged calls + * pyproject: Add missing pytest marker for "tags" + * setup: Perform a check for app availability after the page loads + * sogo: Allow adding IMAP accounts and changing full name + * templates: Show Launch web client button for all !FreedomBox URLs + * tests: Ensure that privileged daemon is not used during tests + * tiddlywiki: Avoid "412: Precondition failed" error + * tiddlywiki: Don't allow index.html as a file name + * ui: Fix user menu popup overflowing beyond the page + * ui: Use system's UI fonts on all platforms instead of Lato + * uninstall: Use reverse order when uninstalling components + * views: Remove unused code related to refresh packages button + +== FreedomBox 25.9.4 (2025-08-02) == + + * distupgrade: Handle comments in sources.list file + * distupgrade: Update Trixie's release date as announced + +== FreedomBox 25.9.3 (2025-07-21) == + + * config: Allow overriding target path in dropin config component + * email: Add support for Dovecot 2.4 + * email: Start servers during re-setup if they are not running + * locale: Update translations for Albanian, Bulgarian, Catalan, Estonian, Tamil + * sogo: Fix typo in configuration for sieve server + +== FreedomBox 25.9.2 (2025-06-23) == + + * debian: Set the branch for trixie + * debian: Update debconf Portuguese translation + * locale: Add new translation for Estonian + * locale: Update translations for Dutch, German, Hungarian + * performance: Handle install for trixie + +== FreedomBox 25.9.1 (2025-06-02) == + + * locale: Update translations for Catalan, Telugu, Ukrainian + == FreedomBox 25.9 (2025-05-05) == * locale: Add translation for Catalan diff --git a/doc/manual/en/Upgrades.raw.wiki b/doc/manual/en/Upgrades.raw.wiki index ddac27c1c..99ee5b719 100644 --- a/doc/manual/en/Upgrades.raw.wiki +++ b/doc/manual/en/Upgrades.raw.wiki @@ -10,7 +10,7 @@ !FreedomBox can automatically install security updates. On the ''Update'' page of the ''System'' section in !FreedomBox web interface you can turn on automatic updates. This feature is enabled by default and there is no manual action necessary. It is strongly recommended that you have this option enabled to keep your !FreedomBox secure. -Updates are performed every day at night according to you local time zone. You can set the time zone with [[FreedomBox/Manual/DateTime|Date & Time]]. If you wish to shutdown !FreedomBox every day after use, keep it running at night once a week or so to let the automatic updates happen. Alternatively, you can perform manual updates as described below. +Updates are performed every day at night according to the time zone you have set on your machine. You can set the time zone with [[FreedomBox/Manual/DateTime|Date & Time]]. If you wish to shutdown !FreedomBox every day after use, keep it running at night once a week or so as to allow automatic updates to happen. Alternatively, you can perform manual updates as described below. Note that once the updates start, it may take a long time to complete. During automatic update process that runs every night or during manual update process, you will not be able to install apps from !FreedomBox web interface. @@ -20,29 +20,21 @@ Note that once the updates start, it may take a long time to complete. During au Although updates are done every day for security reasons, latest features of !FreedomBox will not propagate to all the users. The following information should help you understand how new features become available to users. -'''Stable Users''': This category of users include users who bought the [[FreedomBox/Hardware/PioneerEdition|FreedomBox Pioneer Edition]], installed !FreedomBox on a [[FreedomBox/Hardware/Debian|Debian]] stable distribution or users who downloaded the ''stable'' images from [[https://freedombox.org|freedombox.org]]. As a general rule, only security updates to various packages are provided to these users. One exception to this rule is where !FreedomBox service itself is updated when a release gains high confidence from developers. This means that latest !FreedomBox features may become available to these users although not as quickly or frequently as ''testing'' users. If an app is available only in ''testing'' distribution but not in ''stable'' distribution, then that app will show up in the web interface but will not be installable by ''stable'' users. Some apps are also provided an exception to the rule of "security updates only" when the app is severely broken otherwise. Every two years, a major release of Debian stable happens with the latest versions of all the software packages and !FreedomBox developers will attempt to upgrade these users to the new release without requiring manual intervention. +'''Stable Users''': This category of users include users who bought the [[FreedomBox/Hardware/PioneerEdition|FreedomBox Pioneer Edition]], installed !FreedomBox on a [[FreedomBox/Hardware/Debian|Debian]] stable distribution or users who downloaded the ''stable'' images from [[https://freedombox.org|freedombox.org]]. As a general rule, only security updates to various packages are provided to these users. One exception to this rule is where !FreedomBox service itself is updated when a release gains high confidence from developers. This means that latest !FreedomBox features may become available to these users although after a few days of delay compared to ''testing'' users. If an app is available only in ''testing'' distribution but not in ''stable'' distribution, then that app will show up in the web interface but will not be installable by ''stable'' users. Some apps are also provided an exception to the rule of "security updates only" when the app is severely broken otherwise. Every two years, a major release of Debian stable happens with the latest versions of all the software packages and !FreedomBox developers will attempt to upgrade these users to the new release without requiring manual intervention. See the sections on upgrade to next stable release below. '''Testing Users''': This category of users include users who installed !FreedomBox on a [[FreedomBox/Hardware/Debian|Debian]] ''testing'' distribution or users who downloaded the ''testing'' images from [[https://freedombox.org|freedombox.org]]. Users who use Debian ''testing'' are likely to face occasional disruption in the services and may even need manual intervention to fix the issue. As a general rule, these users receive all the latest features and security updates to all the installed packages. Every two weeks, a new version of !FreedomBox is released with all the latest features and fixes. These releases will reach ''testing'' users approximately 2-3 days after the release. -'''Unstable Users''': This category of users include users who installed !FreedomBox on a [[FreedomBox/Hardware/Debian|Debian]] ''unstable'' distribution or users who downloaded the ''unstable'' images from [[https://freedombox.org|freedombox.org]]. Users who use Debian ''unstable'' are likely to face occasional disruption in the services and may even need manual intervention to fix the issue. As a general rule, these users receive all the latest features to all the installed packages. Every two weeks, a new version of !FreedomBox is released with all the latest features and fixes. Theses releases will reach ''unstable'' users on the day of the release. Only developers, testers and other contributors to the !FreedomBox project should use the ''unstable'' distribution and end users and advised against using it. +'''Unstable Users''': This category of users include users who installed !FreedomBox on a [[FreedomBox/Hardware/Debian|Debian]] ''unstable'' distribution or users who downloaded the ''unstable'' images from [[https://freedombox.org|freedombox.org]]. Users who use Debian ''unstable'' are likely to face occasional disruption in the services and may even need manual intervention to fix the issue. As a general rule, these users receive all the latest features to all the installed packages. Every two weeks, a new version of !FreedomBox is released with all the latest features and fixes. Theses releases will reach ''unstable'' users on the day of the release. Only developers, testers and other contributors to the !FreedomBox project should use the ''unstable'' distribution. End users are advised against using it. === Manual Updates from Web Interface === -To get updates immediately and not wait until the end of the day, you may want to trigger updates manually. You can do this by pressing the ''Update now'' button in ''Manual update'' tab for ''Update'' page in ''System'' section. Note that this step is not necessary if you have enabled ''Auto-updates'' as every night this operation is performed automatically. - -When installing apps you may receive an error message such as - -{{{ -Error installing packages: E: dpkg was interrupted, you must manually run 'dpkg --configure -a' to correct the problem -}}} - -This is typically caused by shutting down !FreedomBox while it is installing apps, while performing daily updates or during some other operations. This situation can be rectified immediately by running manual update. +To get updates immediately and not wait until the end of the day, you may want to trigger updates manually. You can do this by pressing the ''Update now'' button under ''Manual update'' heading for ''Software Update'' page in ''System'' section. Note that this step is not necessary if you have enabled ''Auto-updates'' as every night this operation is performed automatically. === Manual Updates from Terminal === -Some software packages may require manual interaction for updating due to questions related to configuration. In such cases, !FreedomBox updates itself and brings in new knowledge necessary to update the package by answering configuration questions. After updating itself, !FreedomBox acts on behalf of the user and updates the packages by answering the questions. Until !FreedomBox has a chance to update the package, such packages should not be be updated manually. The manual update triggered from the web interface is already mindful of such packages and does not update them. +Some software packages may require manual interaction for updating due to questions related to configuration. In such cases, !FreedomBox updates itself and brings in new knowledge necessary to update the package. Then, !FreedomBox acts on behalf of the user and updates the packages by answering the questions. Until !FreedomBox has a chance to update the package, such packages should not be be updated manually from the terminal. The manual update triggered from the web interface is already mindful of such packages and does not update them. -In some rare situations, !FreedomBox itself might fail to update or the update mechanism might fall into a situation that might need manual intervention from a terminal. To perform manual upgrades on the terminal, login into !FreedomBox on a terminal (if you have monitor and keyboard connected), via a web terminal (using [[FreedomBox/Manual/Cockpit]]) or using a remote secure shell (see [[FreedomBox/Manual/SecureShell|Secure Shell]] section). Then run the following commands: +In some rare situations, !FreedomBox itself might fail to update or the update mechanism might fall into a situation that might need manual intervention from a terminal. To perform manual upgrades on the terminal, login into !FreedomBox on a terminal (if you have monitor and keyboard connected), via a web terminal (using [[FreedomBox/Manual/Cockpit|Cockpit]]) or using a remote secure shell (see [[FreedomBox/Manual/SecureShell|Secure Shell]] section). Then run the following commands: {{{ $ sudo su - @@ -65,23 +57,42 @@ $ apt full-upgrade === Auto-Update to Next Stable Release === -!FreedomBox can automatically update itself when there is a new stable release of Debian. This update feature is recommended, and enabled by default for stable systems. Note that it also requires "Enable auto-update" to be enabled, and that there is 5 GB free space on the root partition. +!FreedomBox can automatically update itself when there is a new stable release of Debian. This update feature is recommended, and enabled by default for ''stable'' systems. Note that it also requires "Enable auto-update" to be enabled, and there should be 5 GB of free space on the OS (root) partition. -In some special cases, such as advanced customization made to the system, the automatic update could fail. If you wish, you can disable it on the System -> Update page, by clearing the “Enable auto-update to next stable release” checkbox. +In some special cases, such as advanced customization made to the system, the automatic update could fail. If you wish, you can disable it on the ''System'' -> ''Software Update'' page, by clearing the “Enable auto-update to next stable release” checkbox. -If you decide to stay on an older release, you should check DebianReleases#Production_Releases to see how long it will be supported by Debian security team. Note that older releases will not have new versions of !FreedomBox, even through backports. +If you decide to stay on an older release, you should check [[https://www.debian.org/releases/|Debian Releases]] and [[LTS|Long Term Support]] pages to see how long it will be supported by Debian security team. You stop using an older release if it stops receiving security updates. Note that older releases will not have new versions of !FreedomBox (unless there is a security update), even through backports. === Manual Update to Next Stable Release === -Auto-update is recommended for most users. However if you want to do the update manually, here are some tips: +Thirty days after the release of a Debian stable release, all users will be upgraded to the next stable release. This behavior can be disabled as described above and users may choose to upgrade at a time for any the following reasons: + * If you don't want to wait 30 days and want to get the new stable release immediately. + * If you want to keep your working setup stable and not risk changing it (major OS upgrades are somewhat risky). You can potentially keep your distribution for years without change. + * If you want to minimize disruption during upgrade process by choosing a time convenient to you. + * If your favorite app is no longer supported in the new stable release and you will need time to migrate away to an alternative. + * If you want to take full backups before distribution upgrade happens and be on stand by to restore it if something goes wrong. + * If you want to test the upgrade process ahead of other users and report any problems to the development team. - * Take backups of your apps' data before performing the update. +Here are some tips before you begin manual update to next stable release: + + * Take backups of your apps' data before performing the update. Making a copy of your entire disk using cloning software is even better. * Create a system snapshot before you begin. - * General [[DebianUpgrade|instructions]] for upgrading Debian distribution are available. - * Some packages are known to have prompts during upgrade, due to modified conffiles. It is recommended not to upgrade these packages manually, but rather to allow !FreedomBox to handle their upgrade automatically. For upgrade to Debian 13 "trixie", this applies to the following packages: - * firewalld - * minidlna - * radicale + * General [[DebianUpgrade|instructions]] for upgrading Debian distribution are available but this approach can't handle the configuration changes needed for the new versions of software. + * Some software requires additional update operations that !FreedomBox performs as soon as it starts up after the distribution update. Please allow some time for these operations to complete after a distribution update. These apps include: + * Postfix/Dovecot (requires a new configuration file format) + * !MediaWiki (requires database to be upgraded) + * Some packages are known to have prompts during upgrade, due to modified configuration files. It is recommended not to upgrade these packages manually, but rather to allow !FreedomBox to handle their upgrade automatically. For upgrade to Debian 13 "trixie", this applies to the following packages: + * Firewalld + * Minidlna + * Radicale + * Some packages may not be available after upgrade to next release. Please migrate to a similar application before or after the upgrade process. For upgrade to Debian 13 "trixie", the following apps are no longer available: + * Janus. Use audio/video calling over Matrix or XMPP or audio calling over Mumble. This app will likely become available in future again. + * TT-RSS. Migrate to Miniflux. + * Searx. + +To initiate the distribution update process, go to ''Software Update'' in ''System'' section. Then ''Enable auto-update'' and ''Enable auto-update to next stable release'' option. Then click on the ''Distribution Update'' button. Then click the ''Start Distribution Update'' button. The process may take several hours if your OS is on a slow disk such as an SD card. !FreedomBox web UI may not be available during upgrade. Refresh the page if the page errors out. Finally, allow more time for post-upgrade processes and restart the machine. + +{{attachment:distribution-update.png}} ## END_INCLUDE diff --git a/doc/manual/en/freedombox-manual.raw.wiki b/doc/manual/en/freedombox-manual.raw.wiki index b680f0068..93490862f 100644 --- a/doc/manual/en/freedombox-manual.raw.wiki +++ b/doc/manual/en/freedombox-manual.raw.wiki @@ -28,6 +28,7 @@ <> <> <> +<> <> <> <> @@ -80,6 +81,9 @@ <> <> += Guides = +<> + = Hardware = <> <> diff --git a/doc/manual/en/images/cubieboard2_thumb.jpg b/doc/manual/en/images/cubieboard2_thumb.jpg index 5f9eab185..fe77bd519 100644 Binary files a/doc/manual/en/images/cubieboard2_thumb.jpg and b/doc/manual/en/images/cubieboard2_thumb.jpg differ diff --git a/doc/manual/en/images/distribution-update.png b/doc/manual/en/images/distribution-update.png new file mode 100644 index 000000000..112046596 Binary files /dev/null and b/doc/manual/en/images/distribution-update.png differ diff --git a/doc/manual/en/images/kiwix-tile.png b/doc/manual/en/images/kiwix-tile.png new file mode 100644 index 000000000..9e27693e3 Binary files /dev/null and b/doc/manual/en/images/kiwix-tile.png differ diff --git a/doc/manual/en/images/ui_add_security_exception.png b/doc/manual/en/images/ui_add_security_exception.png deleted file mode 100644 index 66a94dbbf..000000000 Binary files a/doc/manual/en/images/ui_add_security_exception.png and /dev/null differ diff --git a/doc/manual/en/images/ui_apps.png b/doc/manual/en/images/ui_apps.png index 061699d53..7f815adab 100644 Binary files a/doc/manual/en/images/ui_apps.png and b/doc/manual/en/images/ui_apps.png differ diff --git a/doc/manual/en/images/ui_burger_icon.png b/doc/manual/en/images/ui_burger_icon.png index dd55f3bc2..89caa0479 100644 Binary files a/doc/manual/en/images/ui_burger_icon.png and b/doc/manual/en/images/ui_burger_icon.png differ diff --git a/doc/manual/en/images/ui_burger_menu.png b/doc/manual/en/images/ui_burger_menu.png index 7f40b8263..b57abbeed 100644 Binary files a/doc/manual/en/images/ui_burger_menu.png and b/doc/manual/en/images/ui_burger_menu.png differ diff --git a/doc/manual/en/images/ui_firstboot_account.png b/doc/manual/en/images/ui_firstboot_account.png index a35a44534..d17482581 100644 Binary files a/doc/manual/en/images/ui_firstboot_account.png and b/doc/manual/en/images/ui_firstboot_account.png differ diff --git a/doc/manual/en/images/ui_firstboot_complete.png b/doc/manual/en/images/ui_firstboot_complete.png index 052a1e7ff..ce3712b8c 100644 Binary files a/doc/manual/en/images/ui_firstboot_complete.png and b/doc/manual/en/images/ui_firstboot_complete.png differ diff --git a/doc/manual/en/images/ui_firstboot_complete_notification.png b/doc/manual/en/images/ui_firstboot_complete_notification.png new file mode 100644 index 000000000..d06ec324a Binary files /dev/null and b/doc/manual/en/images/ui_firstboot_complete_notification.png differ diff --git a/doc/manual/en/images/ui_firstboot_feature_updates.png b/doc/manual/en/images/ui_firstboot_feature_updates.png new file mode 100644 index 000000000..f4dfcff9a Binary files /dev/null and b/doc/manual/en/images/ui_firstboot_feature_updates.png differ diff --git a/doc/manual/en/images/ui_frontpage.png b/doc/manual/en/images/ui_frontpage.png index 821880c36..2b3ae0bac 100644 Binary files a/doc/manual/en/images/ui_frontpage.png and b/doc/manual/en/images/ui_frontpage.png differ diff --git a/doc/manual/en/images/ui_frontpage_with_app.png b/doc/manual/en/images/ui_frontpage_with_app.png index 20e188f93..554947f92 100644 Binary files a/doc/manual/en/images/ui_frontpage_with_app.png and b/doc/manual/en/images/ui_frontpage_with_app.png differ diff --git a/doc/manual/en/images/ui_help.png b/doc/manual/en/images/ui_help.png index 531c1187f..854e26771 100644 Binary files a/doc/manual/en/images/ui_help.png and b/doc/manual/en/images/ui_help.png differ diff --git a/doc/manual/en/images/ui_insecure_connection.png b/doc/manual/en/images/ui_insecure_connection.png index 2068d91a5..fb3249c8a 100644 Binary files a/doc/manual/en/images/ui_insecure_connection.png and b/doc/manual/en/images/ui_insecure_connection.png differ diff --git a/doc/manual/en/images/ui_system.png b/doc/manual/en/images/ui_system.png index b4116edd2..524ca82fe 100644 Binary files a/doc/manual/en/images/ui_system.png and b/doc/manual/en/images/ui_system.png differ diff --git a/doc/manual/en/images/ui_user_menu.png b/doc/manual/en/images/ui_user_menu.png index 6ad660acc..b8bbfa936 100644 Binary files a/doc/manual/en/images/ui_user_menu.png and b/doc/manual/en/images/ui_user_menu.png differ diff --git a/doc/manual/en/images/update.png b/doc/manual/en/images/update.png index 716f63cd7..94458498d 100644 Binary files a/doc/manual/en/images/update.png and b/doc/manual/en/images/update.png differ diff --git a/doc/manual/es/A20-OLinuXino-Lime2.raw.wiki b/doc/manual/es/A20-OLinuXino-Lime2.raw.wiki index 6974528a6..f73b75aff 100644 --- a/doc/manual/es/A20-OLinuXino-Lime2.raw.wiki +++ b/doc/manual/es/A20-OLinuXino-Lime2.raw.wiki @@ -43,7 +43,7 @@ An alternative to downloading these images is to [[InstallingDebianOn/Allwinner| === Known Issues === - * Revision G2 (written on the board): The current stable Debian11/bullseye image (from 2021-08-27) '''will not start an Ethernet connection!''' This means you can not continue with the installation process at first. This can be fixed by following [[https://wiki.debian.org/InstallingDebianOn/Allwinner#Olimex_A20-OLinuXino-LIME2__rev._F_and_newer_and_Debian11.2F_bullseye_kernel | this description]] after you [[https://wiki.debian.org/FreedomBox/Download#Installation | copied the image to your SD card]]. Or you Download and use the [[https://ftp.freedombox.org/pub/freedombox/pioneer/|Pioneer Edition image]] to fix the issue. It contains a slightly [[https://salsa.debian.org/freedombox-team/u-boot/commit/2cb18893ef|modified u-boot]]. + * Revision G2 (written on the board): The current stable Debian11/bullseye image (from 2021-08-27) '''will not start an Ethernet connection!''' This means you can not continue with the installation process at first. This can be fixed by following [[https://wiki.debian.org/InstallingDebianOn/Allwinner#Olimex_A20-OLinuXino-LIME2__rev._F_and_newer_and_Debian11.2F_bullseye_kernel | this description]] after you [[https://wiki.debian.org/FreedomBox/Download#Installation | copied the image to your SD card]]. Or you Download and use the [[https://ftp.freedombox.org/pub/freedombox/hardware/pioneer/|Pioneer Edition image]] to fix the issue. It contains a slightly [[https://salsa.debian.org/freedombox-team/u-boot/commit/2cb18893ef|modified u-boot]]. * Revision G2 hardware has also [[DebianBug:927397|poor performance when transmitting Ethernet data in Gigabit mode]] for older FreedomBox releases. The procedure above or for rev. C fixes this. * Revision C hardware has [[DebianBug:845128|poor performance when receiving Ethernet data in Gigabit mode]]. To workaround the problem, you can switch to 100 Mbps mode instead of Gigabit mode. Login to your !FreedomBox as root (or plugin the SD card into another computer) and create the file /etc/NetworkManager/dispatcher.d/20-fix-ethernet-problem with the following contents: diff --git a/doc/manual/es/Cubieboard2.raw.wiki b/doc/manual/es/Cubieboard2.raw.wiki index aad8164d0..ee1b6cb19 100644 --- a/doc/manual/es/Cubieboard2.raw.wiki +++ b/doc/manual/es/Cubieboard2.raw.wiki @@ -37,4 +37,4 @@ The Cubieboard 2 is a single board computer based on the Allwinner A20 processor CategoryFreedomBox -Cubieboard 2 image is licensed under a Creative Commons Attribution-!ShareAlike 2.0 Generic License by [[https://www.flickr.com/photos/120586634@N05/14673300334/in/photolist-pMbdDm-omCuYN-o5kVMu-dy9jTD-dy99Kz|Flickr]]. +Cubieboard 2 image is licensed under the [[https://creativecommons.org/licenses/by-sa/2.0/|Creative Commons Attribution-Share Alike 2.0 Generic license]] by [[https://commons.wikimedia.org/wiki/File:Cubieboard_2_-_Top_(14673300334).jpg|Gareth Halfacree]]. diff --git a/doc/manual/es/Download.raw.wiki b/doc/manual/es/Download.raw.wiki index 03b06a1d4..bd3ca01a9 100644 --- a/doc/manual/es/Download.raw.wiki +++ b/doc/manual/es/Download.raw.wiki @@ -170,7 +170,7 @@ En MacOS (OSX) puedes usar programas como ''balenaetcher'' y ''rosaimagewriter'' === Desde (dentro de) FreedomBox === -!FreedomBox se compone de diferentes programas de software y puedes obtener el código fuente de cualquiera de ellos. Estas instrucciones son similares a obtener y [[https://www.debian.org/doc/manuals/maint-guide/build.en.html|construír]] [[https://www.debian.org/doc/manuals/apt-howto/ch-sourcehandling.en.html|código fuente]] [[https://wiki.debian.org/BuildingTutorial|de Debian]] ya que !FreedomBox es una variante pura de Debian. Usando este procedimiento puedes obtener el código fuente de la misma versión del paquete que estás usando actualmene en !FreedomBox. +!FreedomBox se compone de diferentes programas de software y puedes obtener el código fuente de cualquiera de ellos. Estas instrucciones son similares a obtener y [[https://www.debian.org/doc/manuals/maint-guide/build.en.html|construír]] [[https://wiki.debian.org/Packaging/SourcePackage#How_to_Download_a_source_package|código fuente]] [[https://wiki.debian.org/BuildingTutorial|de Debian]] ya que !FreedomBox es una variante pura de Debian. Usando este procedimiento puedes obtener el código fuente de la misma versión del paquete que estás usando actualmene en !FreedomBox. 1. Para ver la lista de paquetes software instalados en tu !FreedomBox, ejecuta lo siguiente en un terminal: {{{ diff --git a/doc/manual/es/ExposeLocalService.raw.wiki b/doc/manual/es/ExposeLocalService.raw.wiki new file mode 100644 index 000000000..dff4c97a0 --- /dev/null +++ b/doc/manual/es/ExposeLocalService.raw.wiki @@ -0,0 +1,154 @@ +#language es +<> + +<> + +## BEGIN_INCLUDE + +== Exponer un Servicio Local a Internet usando FreedomBox == + +Esta guía describe cómo exponer un servicio local de tu red local a internet usando una FreedomBox que ya está expuesta a internet. + +=== Escenario === + + * ''Tienes una !FreedomBox ejecutando'' con un dominio ya configurado y funcional. Puedes acceder a tu !FreedomBox usando una URL como `https://mi.sitio` . + * ''Tienes otro servidor proporcionando un servicio local'' a la LAN que quieres exponer a Internet en el mismo dominio de tu !FreedomBox. El servicio local tiene que ser de tipo web y usar el protocolo HTTP (también es posible configurar servicios no HTTP, pero eso es otro caso). Opcionalmente el servicio puede tener un dominio propio. + * Quieres que ''!FreedomBox maneje los certificados TLS'' para este dominio como suele hacer con los suyos. Tu servicio no necesitará configurarlos ni administrarlos. + * Opcionalmente, quizá quieras ''limitar el acceso al servicio local usando las credenciales de !FreedomBox''. Solo los usuarios con una cuenta en la !FreedomBox (que pertenezcan a un grupo específico) podrán acceder a este servicio. El servicio local no estará disponible a cualquiera en internet. De este modo puedes alojar servicios locales que no implementen su propia autenticación o servicios locales con sus mecanismos de autenticación deshabilitados. + +=== Exponer Servidores de la LAN === + + * Para exponer el servicio, crea un fichero de configuración de Apache en `/etc/apache2/conf-available/` y escribe una directiva `ProxyPass`. Suponiendo que tu servicio local está publicado en la dirección IP local `192.168.0.20` en el puerto `3000`, lo harías ejecutando la orden (como usuario root en la terminal): + + {{{#!highlight bash +cat > /etc/apache2/conf-available/mi-servicio-local.conf < + Include includes/freedombox-single-sign-on.conf + + ProxyPass http://192.168.0.20:3000/ + +}}} + 1. Luego se inicia el servidor web Apache. + {{{#!highlight bash +systemctl reload apache2 +}}} + +Si quieres restringir el acceso al servicio a solo algunos grupos de usuarios necesitas otro cambio más en la configuración. El siguiente ejemplo lo restringe a usuarios de los grupos “web-search” y “admin”. Se denegará el acceso a todos los demás usuarios aunque tengan una cuenta válida en tu !FreedomBox. + +{{{#!highlight apache + + Include includes/freedombox-single-sign-on.conf + + + TKTAuthToken "web-search" "admin" + + + ProxyPass http://192.168.0.20:3000/ + +}}} + +=== Alojar el servicio en otro dominio === + +Algunos servicios y aplicaciones web no funcionan bien alojados bajo fragmentos de URL como `/miservicio/`. Requieren un dominio o subdominio entéramente dedicado a ellos. !FreedomBox también puede exponer estos servicios. + + 1. Primero obtén un dominio o subdominio. + * Si el dominio es tuyo, ve a los ajustes de DNS de tu proveedor de dominios y añade un subdominio. Puedes crear un registro CNAME que simplemente apunte al dominio. + * Si estás usando el servicio !FreedomBox de DNS Dinámico ingresa a https://ddns.freedombox.org y habilita la opción “Comodín”. Con este cambio, todos los subdominios (como `mi.servicio.fbx.one`) de un mismo dominio (como `fbx.one`) apuntarán al dominio. + 1. Añade el dominio nuevo a tu !FreedomBox en Sistema → Servicios de Nombre → Dominio (normal) → Añadir. Por ejemplo, añade `mi.sitio`. + 1. A continuación, crea un fichero de configuración de Apache en `/etc/apache2/includes/-include.conf`. Para nuestro ejemplo, sería: `/etc/apache2/includes/miservicio.mi.sitio-include.conf`. El contenido del fichero debe ser: + {{{#!highlight apache +ProxyPass / http://192.168.0.20:3000/ +}}} + 1. Si fuera necesario, modifica el fichero anterior para exigir autenticación añadiendo las directivas `Include` e `` como se muestra en a sección de autenticación. + +=== Problemas === + +Para depurar cuando la configuración no funcione como se espera, ejecuta temporalmente un servicio web en tu !FreedomBox. + + 1. Crea un directorio temporal con una página index.html en la !FreedomBox. + {{{#!highlight bash +mkdir temp +cd temp +cat > index.html < + + + Mi página de prueba + + +

Hola gente!

+ + +EOL +}}} + 1. Ejecta un servidor web temporal (Control-C para pararlo): + {{{#!highlight bash +python3 -m http.server 3000 +}}} + 1. Actualiza la configuración de Apache para apuntar al servicio temporal de la !FreedomBox. + {{{#!highlight apache +ProxyPass /myservice http://127.0.0.1:3000/ +}}} + +=== Extras === + +Apache puede proporcionar muchas otras funcionalidades para mejorar el servicio local. Mira la [[https://httpd.apache.org/docs/current/|documentación de Apache]]. Estas son algunas: + + * Acelerar la respuesta del servicio sirviendo ficheros estáticos como JS, CSS, y audiovisuales desde un directorio local sin invocar al servicio. + * Acelerar la respuesta cacheando las respuestas del servicio. + * Inyectar cabeceras para seguridad, control de cache, etc. + * Modificar las cabeceras HTTP de las respuestas del serviciocuando no funciona bien alojado bajo fragmentos de URL como `/miservicio/`. + * Redireccionar desde URLs `http://` a `https://` y establecer cabeceras HSTS. + * Balancear carga entre varios servicios locales para alta disponibilidad, escalado, etc. + * Etc. + +## END_INCLUDE + +Volver a la [[es/FreedomBox/Features|descripción de Funcionalidades]] o a las páginas del [[es/FreedomBox/Manual|manual]]. + +<> + +---- +CategoryFreedomBox diff --git a/doc/manual/es/Kiwix.raw.wiki b/doc/manual/es/Kiwix.raw.wiki new file mode 100644 index 000000000..43dc4c1ec --- /dev/null +++ b/doc/manual/es/Kiwix.raw.wiki @@ -0,0 +1,62 @@ +#language es +<> + +<> + +## BEGIN_INCLUDE + +== Kiwix (Wikipedia sin conexión) == + +'''Disponible desde:''' versión 23.19 + +|| {{attachment:FreedomBox/Manual/Kiwix/kiwix-tile.png|Icono de Kiwix}} || + +[[https://es.wikipedia.org/wiki/Kiwix|Kiwix]] puede servir archivos de sitios web si conexión. Se creó originalmente para servir una versión de la Wikipedia, la enciclopedia libre, sin conexión. + +=== Casos de uso === + +[[https://en.wikibooks.org/wiki/FreedomBox_for_Communities|FreedomBox for Communities]] estuvo usando Kiwix años antes de incluirla officialmente como app. +Kiwix se empleó para servir contenido en redes Wi-Fi comunitarias en [[https://en.wikipedia.org/wiki/Gangadevipalli#Free_Community_WiFi|pueblos]] de la India con acceso a Internet poco fiable o insuficiente. +Además de una versión de la Wikipedia sin conexión, Kiwix sirvó + * el archivo "Wikipedia for Schools" que lo emplearon profesores y estudiantes para deberes y como apoyo par la docencia. + * elarchivo "!WikiSource (en Telugu)" que sirvió como biblioteca digital. + +Kiwix también es útil con acceso a Internet fiable. + 1. Archivo y preservación: Se pueden crear archivos de sitios web y preservarlos como ficheros ZIM. Kiwix puede servir estos ficheros. + 2. Acceso rápido a sitios web lentos: Un archivo estático puede ser más rápido de acceder. + 3. Acceso a sitios web temporalmente indisponibles. Por ejemplo, The Low Tech Magazine se aloja en un ordenador monoplaca alimentado por electricidad solary a veces se cae la conexión. Hay un archivo Kiwix disponible que se puede ajojar localmente. + +=== Kiwix en FreedomBox === + +!FreedomBox sirve el paquete Debian DebPkg:kiwix-tools que permite administrar y servir archivos de contenido en formato ZIM. +Los ficheros ZIM los pueden añadir o borrar un administrador de la !FreedomBox o cualquier usuario del grupo "kiwix". + +Kiwix sólo está disponible en !FreedomBox mediante el interfaz web. Hay clientes Kiwix para móvil y escritorio, pero solo peden leer ficheros locales. +No pueden bajar contenido desde el Kiwix alojado en !FreedomBox. + +Por omisión, el interfaz web de Kiwix está disponible para acceso publico + +=== Encontrar ficheros con contenido === + +Para localizar contenido para Kiwix, vé a [[https://library.kiwix.org|library.kiwix.org]]. Puedes descargar ficheros (llamados "libros") mediante descarga directa mediante BitTorrent. +El propio sitio web es una instalación Kiwix, así que puedes previsualizar el contenido antes de descargarlo, para comprobar su integridad. + +Una fuente alternativa para los mismos ficheros es [[https://wiki.kiwix.org/wiki/Main_Page|wiki.kiwix.org]], un wiki con enlaces de descarga y más información acerca del proyecto Kiwix. + +=== Crear ficheros con contenido === + +El proyecto [[https://openzim.org/|OpenZim]] mantiene herramientas para crear ficheros ZIM. La herramienta [[https://github.com/openzim/zimit|zimit]] es una solución completa que crea un fichero ZIM a partir de un sitio web. +También puedes solicitar un fichero ZIM en el sitio web [[https://youzim.it|youzim.it]]. + +=== Enlaces externos === + + * Proyecto original: https://kiwix.org + * Documentación original: https://kiwix.org/frequently-asked-questions +## END_INCLUDE + +Volver a la [[es/FreedomBox/Features|descripción de Funcionalidades]] o a las páginas del [[es/FreedomBox/Manual|manual]]. + +<> + +---- +CategoryFreedomBox diff --git a/doc/manual/es/Manual.raw.wiki b/doc/manual/es/Manual.raw.wiki index b680f0068..93490862f 100644 --- a/doc/manual/es/Manual.raw.wiki +++ b/doc/manual/es/Manual.raw.wiki @@ -28,6 +28,7 @@ <> <> <> +<> <> <> <> @@ -80,6 +81,9 @@ <> <> += Guides = +<> + = Hardware = <> <> diff --git a/doc/manual/es/QuickStart.raw.wiki b/doc/manual/es/QuickStart.raw.wiki index 11247e480..4f536f867 100644 --- a/doc/manual/es/QuickStart.raw.wiki +++ b/doc/manual/es/QuickStart.raw.wiki @@ -53,7 +53,7 @@ Alternativamente podrías optar por montarlo tu mismo reuniendo todas las piezas 1. Al acceder al interfaz web de !FreedomBox tu navegador te avisará de que comunica en modo seguro pero que considera invalido el certificado de seguridad. Tienes que aceptarlo porque el certificado es autogenerado en la !FreedomBox y "autofirmado" (el navegador podría denominarlo "no confiable", "no privado", "error de privacidad" o "emisor/autoridad desconocida"). Decir a tu navegador que ya lo sabes podría implicar accionar algunos botones como "Entiendo los riesgos", "proceder ... (inseguro)" o "Añadir excepción". Después de la instalación este certificado se puede cambiar a otro normal usando la opción ''Let's Encrypt''. - . {{attachment:ui_insecure_connection-es.png|Aviso de certificado autofirmado|width=600}} + . {{attachment:ui_insecure_connection-es.png|Aviso de certificado autofirmado|width=500}} . {{attachment:ui_add_security_exception-es.png|Añadir excepción de seguridad|width=400}} Si el nombre de dominio que usas tiene un certificado válido de una authoridad de certificación reconocida, como ''Let's Encrypt'' no podrás acceder al interfaz web. Por ello no se te ofrecerá la opción de continuar. Esto podría ocurrir, por ejemplo, si estás reinstalando tu FreedomBox o estás reutilizande de algón modo un nombre de dominio con un certificado asociado. Esto es normal, porque tu navegador recuerda haber visitado el sitio con el certificado oficial válido. En consecuancia el navegador no aceptará un certificado autofirmado y te verás bloqueado. Hay dos maneras de superar este obstáculo. @@ -68,8 +68,10 @@ Alternativamente podrías optar por montarlo tu mismo reuniendo todas las piezas 1. La siguiente página te pide un nombre de usuario y contraseña. Rellena el formulario y haz clic en "Crear Cuenta." * Nota: El usuario que creas aquí tendrá privilegios de ``Admin`` y también podrá [[es/FreedomBox/Manual/SecureShell|entrar por SSH]]. Por mayor seguridad deberías emplear para tareas administrativas una cuenta diferente de la de uso habitual. Luego puedes añadir más usuarios, entre ellos el tuyo de uso habitual. . {{attachment:ui_firstboot_account-es.png|Cuenta|width=500}} - 1. Tras completar el formulario estarás en el interfaz web de !FreedomBox y podrás acceder a las apps y a la configuración mediante el interfaz web. - . {{attachment:ui_firstboot_complete-es.png|Completado|width=500}} + 1. Tras completar el formulario estarás en el interfaz web de !FreedomBox y se te preguntará si quieres recibir actualizaciones más frecuentes (recomendado). + . {{attachment:FreedomBox/Manual/QuickStart/ui_firstboot_feature_updates.png|Feature Updates|width=500}} + 1. La configuración está completa. Ahora puedes examinar y quizá ajustar varios elementos clave de configuración o ver qué aplicaciones están disponibles. Hasta que las cierres, las notificaciones de la barra del menú te recordarán que revises los elementos clave de configuración. + . {{attachment:ui_firstboot_complete-es.png|Completado|width=500}} Ahora puedes probar [[es/FreedomBox/Features|cualquier App]] disponible en !FreedomBox. == Orientándote == @@ -86,13 +88,13 @@ La página principal tiene accesos directos a las apps instaladas que estén hab === Menú de Aplicaciones === -Al Menú de Aplicaciones se accede por el icono de rejilla que está junto al logo de !FreedomBox. Esta página lista todas las apps disponibles para instalar en tu !FreedomBox. Haz click sobre el nombre de la app para visitar su página, desde la que podrás instalarla y configurarla. +Al Menú de Aplicaciones se accede por el icono de rejilla que está junto al logo de !FreedomBox. Esta página lista todas las apps disponibles para instalar en tu !FreedomBox. Haz click sobre el nombre de la app para visitar su página, desde la que podrás instalarla y configurarla. Las aplicaciones instaladas y habilitadas aparecen antes de las demás disponibles. {{attachment:ui_apps.png|Apps|width=600}} === Menú de Ayuda === -Al Menú de Ayuda se accede por el icono del signo de interrogación de la esquina de arriba a la derecha. Incluye enlaces útiles y el manual de !FreedomBox. +Al Menú desplegable de Ayuda se accede por el icono del signo de interrogación cercano a la esquina de arriba a la derecha. El menú incluye enlaces útiles y el manual de !FreedomBox. {{attachment:ui_help-es.png|Ayuda|width=600}} diff --git a/doc/manual/es/ReleaseNotes.raw.wiki b/doc/manual/es/ReleaseNotes.raw.wiki index fdef425b2..ce93ff860 100644 --- a/doc/manual/es/ReleaseNotes.raw.wiki +++ b/doc/manual/es/ReleaseNotes.raw.wiki @@ -8,6 +8,98 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f The following are the release notes for each !FreedomBox version. +== FreedomBox 25.10 (2025-08-18) == + +=== Highlights === + + * email: Add full text search capability + * homeassistant: Add the most popular app for home automation + +=== Other Changes === + + * *: Update copyright year + * action_utils: Add support for device mappings in podman containers + * action_utils: Allow checking result for service operations + * actions: Add method to handle privileged JSON request to a server + * actions: Allow logging privileged calls to a server differently + * actions: Call to a privileged server if it is available + * actions: Raise a proper exception if privileged module is not found + * actions:privileged: Fix flake8 errors + * apache, letsencrypt: Create a site specific config for all domains + * apache: Add component to host an app on a site's root + * apache: Allow customization to the root of a site + * apache: Generalize TLS config to use certificates only if available + * apache: Make all directory listings more mobile friendly + * app: Don't load apps again + * apps: Fix regression in enabling install button + * config: Allow better Apache default home page + * container: Add component for managing containers using podman + * d/control: Drop dependency on python3-setuptools-git + * debian, pyproject.toml: Remove ancient python3-tomli workaround + * debian: Print warning if version mismatch + * diagnostics: Add collapsible sections for results + * doc: Update man page with option --version + * dovecot: Allow login using email address with dovecot version 2.4 + * dovecot: Fix location of Inbox in dovecot 2.4 + * dynamicdns: Add info about subdomains with Foundation's service + * dynamicdns: Fix a type check error + * dynamicdns: Switch update client to HTTP protocol + * email: Increment app version number to trigger dovecot restart + * featherwiki: Disable caching to avoid 412 errors + * featherwiki: Don't allow index.html as a file name + * forms: Allow showing a None option during domain selection + * letsencrypt: Drop old app migration code + * locale: Update translations for Catalan, Dutch, Estonian, Tamil + * Makefile: Developer setup for privileged daemon + * matrixsynapse: Drop help text for domain selection dropdown + * module_loader: Don't load modules again + * names: Add information about adding static domains/subdomains + * notifications: Add datetime to each notification + * notifications: Fix setting last_update_time + * notifications: Minor styling fix for operation notifications + * package: Refresh apt cache if old and some packages are not found + * package: Uninstall packages even if they are not in apt cache + * plinth: Add --version flag to print version and exit + * privileged: Add /bin file for privileged daemon + * privileged: Add systemd units for socket activating the daemon + * privileged: Introduce a UNIX socket daemon for privileged calls + * pyproject: Add missing pytest marker for "tags" + * setup: Perform a check for app availability after the page loads + * sogo: Allow adding IMAP accounts and changing full name + * templates: Show Launch web client button for all !FreedomBox URLs + * tests: Ensure that privileged daemon is not used during tests + * tiddlywiki: Avoid "412: Precondition failed" error + * tiddlywiki: Don't allow index.html as a file name + * ui: Fix user menu popup overflowing beyond the page + * ui: Use system's UI fonts on all platforms instead of Lato + * uninstall: Use reverse order when uninstalling components + * views: Remove unused code related to refresh packages button + +== FreedomBox 25.9.4 (2025-08-02) == + + * distupgrade: Handle comments in sources.list file + * distupgrade: Update Trixie's release date as announced + +== FreedomBox 25.9.3 (2025-07-21) == + + * config: Allow overriding target path in dropin config component + * email: Add support for Dovecot 2.4 + * email: Start servers during re-setup if they are not running + * locale: Update translations for Albanian, Bulgarian, Catalan, Estonian, Tamil + * sogo: Fix typo in configuration for sieve server + +== FreedomBox 25.9.2 (2025-06-23) == + + * debian: Set the branch for trixie + * debian: Update debconf Portuguese translation + * locale: Add new translation for Estonian + * locale: Update translations for Dutch, German, Hungarian + * performance: Handle install for trixie + +== FreedomBox 25.9.1 (2025-06-02) == + + * locale: Update translations for Catalan, Telugu, Ukrainian + == FreedomBox 25.9 (2025-05-05) == * locale: Add translation for Catalan diff --git a/doc/manual/es/Upgrades.raw.wiki b/doc/manual/es/Upgrades.raw.wiki index 01f2f22e6..1bb948e29 100644 --- a/doc/manual/es/Upgrades.raw.wiki +++ b/doc/manual/es/Upgrades.raw.wiki @@ -8,9 +8,9 @@ == Actualizaciones de Software == -!FreedomBox puede instalar actualizaciones de seguridad automaticamente. Esta funcionalidad viene activada por defecto y no hace falta ninguna acción manual. Puedes activar las actualizaciones automaticas desde el interfaz web de !FreedomBox en la página ''Actualización'' de la sección ''Sistema''. Se recomienda encarecidamente que tengas esta opción habilitada para mantener tu !FreedomBox segura. +!FreedomBox puede instalar actualizaciones de seguridad automáticamente. Esta funcionalidad viene activada por defecto y no hace falta ninguna acción manual. Puedes activar las actualizaciones automáticas desde el interfaz web de !FreedomBox en la página ''Actualización'' de la sección ''Sistema''. Se recomienda encarecidamente que tengas esta opción habilitada para mantener tu !FreedomBox segura. -Las actualizaciones se efectúan cada noche según el huso horario local. Puedes establecerlo mediante [[es/FreedomBox/Manual/DateTime|Fecha y Hora]]. Si quieres apagar tu !FreedomBox cada día después de usarla, déjala ejecutando una noche a la semana más o menos para permitir que ocurran las actualizaciones automaticas. Otra posibilidad es ejecutar actualizaciones manuales como se describe más adelante. +Las actualizaciones se efectúan cada noche según el huso horario local configurado en tu máquina. Puedes establecerlo mediante [[es/FreedomBox/Manual/DateTime|Fecha y Hora]]. Si quieres apagar tu !FreedomBox cada día después de usarla, déjala ejecutando una noche a la semana más o menos para permitir que ocurran las actualizaciones automáticas. Otra posibilidad es ejecutar actualizaciones manuales como se describe más adelante. Nota que una vez comiencen las actualizaciones podría llevarles mucho tiempo completarse. Durante el proceso de actualización (ya sea el automático nocturno o el manual), no podrás instalar aplicaciones desde el interfaz web de !FreedomBox. @@ -20,17 +20,17 @@ Nota que una vez comiencen las actualizaciones podría llevarles mucho tiempo co Aunque las actualizaciones se efectúan a diario por razones de seguridad, las últimas funcionalidades no se propagan a todos los usuarios. A continuación se explica cómo llegan las novedades a los usuarios de las diferentes versiones de Debian: - * '''Usuarios de versiones estables''': Esta categoria de usuarios incluye a los usuarios que compraron la [[es/FreedomBox/Hardware/PioneerEdition|FreedomBox Pioneer Edition]], a los que instalaron !FreedomBox sobre una distribución estable de [[es/FreedomBox/Hardware/Debian|Debian]] y a los que descargaron las imágenes ''estables'' desde [[https://freedombox.org|freedombox.org]]. Como regla general a estos usuarios solo se les proporciona actualizaciones de seguridad de determinados paquetes. Cuando una ''release'' obtiene la confianza de los desarrolladores el propio servicio !FreedomBox se actualiza, lo que supone una excepción a esta regla. Esto implica que las últimas funcionalidades de !FreedomBox estarán disponibles para estos usuarios aunque no tán inmediata- o frecuentemente como para los usuarios de las versiones en pruebas (''testing''). Si una ''app'' sólo está disponible en la distribución en pruebas (''testing'') pero no en la ''estable'' la ''app'' aparecerá en el interfaz web pero no será instalable para los usuarios de la distribución ''estable''. Algunas ''apps'' se actualizan en excepción a la regla de "solo actualizaciones de seguridad" cuando la ''app'' esté seriamente ''rota'' por algún motivo. Debian libera cada bienio una entrega (''release'') con las últimas versiones estables de cada paquete de software y los desarrolladores de !FreedomBox intentarán actualizar a estos usuarios a la nueva entrega (''release'') sin necesidad de intervención manual. + * '''Usuarios de versiones estables''': Esta categoria de usuarios incluye a los usuarios que compraron la [[es/FreedomBox/Hardware/PioneerEdition|FreedomBox Pioneer Edition]], a los que instalaron !FreedomBox sobre una distribución estable de [[es/FreedomBox/Hardware/Debian|Debian]] y a los que descargaron las imágenes ''estables'' desde [[https://freedombox.org|freedombox.org]]. Como regla general a estos usuarios solo se les proporciona actualizaciones de seguridad de determinados paquetes. Cuando una ''release'' obtiene la confianza de los desarrolladores el propio servicio !FreedomBox se actualiza, lo que supone una excepción a esta regla. Esto implica que las últimas funcionalidades de !FreedomBox estarán disponibles para estos usuarios con algunos días de retardo respecto los usuarios de las versiones en pruebas (''testing''). Si una ''app'' sólo está disponible en la distribución en pruebas (''testing'') pero no en la ''estable'' la ''app'' aparecerá en el interfaz web pero no será instalable para los usuarios de la distribución ''estable''. Algunas ''apps'' se actualizan en excepción a la regla de "solo actualizaciones de seguridad" cuando la ''app'' esté seriamente ''rota'' por algún motivo. Debian libera cada bienio una entrega (''release'') con las últimas versiones estables de cada paquete de software y los desarrolladores de !FreedomBox intentarán actualizar a estos usuarios a la nueva entrega (''release'') sin necesidad de intervención manual. Ver las secciones acerca de las actualizaciones a la siguiente publicación estable. * '''Usuarios de versiones en pruebas''': Esta categoria de usuarios incluye a los usuarios que instalaron !FreedomBox sobre una distribución en pruebas (''testing'') y a los que descargaron las imágenes en pruebas (''testing'') desde [[https://freedombox.org|freedombox.org]]. Estos usuarios asumen la posibilidad de afrontar disrupciones ocasionales en los servicios e incluso tener que intervenir manualmente para arreglarlas. Como regla general estos usuarios reciben las últimas funcionalidades y actualizaciones de seguridad para todos los paquetes instalados. Cada quincena se libera una nueva versión de !FreedomBox con todas las últimas funcionalidades y correcciones. Estas versiones llegan a los usuarios de la distribución en pruebas (''testing'') aproximadamente 2 o 3 días después de la liberación. - * '''Usuarios de versiones inestables''': Esta categoria de usuarios incluye a los usuarios que instalaron !FreedomBox sobre una distribución ''inestable'' y a los que descargaron las imágenes ''inestables'' desde [[https://freedombox.org|freedombox.org]]. Estos usuarios asumen la probabilidad de afrontar disrupciones en los servicios y tener que intervenir manualmente para arreglarlas. Como regla general estos usuarios reciben las últimas funcionalidades y actualizaciones de seguridad para todos los paquetes instalados. Cada quincena se libera una nueva versión de !FreedomBox con todas las últimas funcionalidades y correcciones. Estas versiones llegan a los usuarios de la distribución ''inestable'' el mismo día de la liberación. Solo los desarrolladores, probadores y contribuyentes al proyecto !FreedomBox debieran emplear la distribution ''inestable''. Se advierte y exhorta a los usuarios finales de que no la usen. + * '''Usuarios de versiones inestables''': Esta categoría de usuarios incluye a los usuarios que instalaron !FreedomBox sobre una distribución ''inestable'' y a los que descargaron las imágenes ''inestables'' desde [[https://freedombox.org|freedombox.org]]. Estos usuarios asumen la probabilidad de afrontar disrupciones en los servicios y tener que intervenir manualmente para arreglarlas. Como regla general estos usuarios reciben las últimas funcionalidades y actualizaciones de seguridad para todos los paquetes instalados. Cada quincena se libera una nueva versión de !FreedomBox con todas las últimas funcionalidades y correcciones. Estas versiones llegan a los usuarios de la distribución ''inestable'' el mismo día de la liberación. Solo los desarrolladores, probadores y contribuyentes al proyecto !FreedomBox debieran emplear la distribución ''inestable''. Se advierte y exhorta a los usuarios finales de que no la usen. === Actualizaciones Manuales desde el Terminal === -Algunos paquetes de software podrían requerir intervención manual para actualizarlos, generalmente por razones de configuración. En tales casos !FreedomBox se actualiza a sí mismo y solicita información nueva necesaria para la actualización del paquete. Después de autoactualizarse !FreedomBox actúa en nombre del usuario y actualiza los paquetes con la información recabada. Estos paquetes no se deben actualizar manualmente hasta que !FreedomBox tenga la posibilidad de actualizarlos. La actualización que se dispara manualmente desde el interfaz web ya es consciente de estos paquetes y no los actualiza. +Algunos paquetes de software podrían requerir intervención manual para actualizarlos, generalmente por razones de configuración. En tales casos !FreedomBox se actualiza a sí mismo y recaba información nueva necesaria para la actualización del paquete. Después de autoactualizarse !FreedomBox actúa en nombre del usuario y actualiza los paquetes con la información recabada. Estos paquetes no se deben actualizar manualmente hasta que !FreedomBox tenga la posibilidad de actualizarlos. La actualización que se dispara manualmente desde el interfaz web ya es consciente de estos paquetes y no los actualiza. -En situaciones muy extrañas, !FreedomBox podría fallar o quedar a expensas de una intervención manual desde el terminal. Para esto, entra a !FreedomBox por un terminal, ya sea físico, web (empleando [[es/FreedomBox/Manual/Cockpit|Cockpit]]) o mediante SSH (ver sección [[es/FreedomBox/Manual/SecureShell|Shell Segura]]) y ejecuta los siguientes comandos: +En situaciones muy extrañas, !FreedomBox podría fallar o quedar a expensas de una intervención manual desde el terminal. Para esto, entra a !FreedomBox por un terminal, ya sea físico, web (empleando [[es/FreedomBox/Manual/Cockpit|Cockpit]]) o mediante SSH (ver sección [[es/FreedomBox/Manual/SecureShell|Shell Segura]]) y ejecuta las siguientes órdenes: {{{ $ sudo su - @@ -55,23 +55,41 @@ $ apt full-upgrade === Autoactualización a la próxima publicación estable === -!FreedomBox puede actualizarse automaticamente cuando se publica una nueva versión estable de Debian. Esta funcionalidad de actualización se recomienda y viene activada por omisión para sistemas estables. Nótese que se requiere activar la autoactualización y que haya 5 GB de espacio libre en la partición raíz. +!FreedomBox puede actualizarse automáticamente cuando se publica una nueva versión estable de Debian. Esta funcionalidad de actualización se recomienda y viene activada por omisión para sistemas estables. Nótese que se requiere activar la autoactualización y que haya 5 GB de espacio libre en la partición raíz. En algunos casos especiales como en los que se haya efectuado una personalización del sistema avanzada la actualización automática podría fallar. Si quieres puedes desactivarla en la página ''Sistema'' -> ''Actualización'' vaciando la caja “Activar autoactualización a la próxima publicación estable”. -Si decides permanecer en una publicación anterior deberías mirar DebianReleases#Production_Releases para ver cuánto tiempo va a soportarla el equipo de seguridad de Debian. Ten en cuenta que las publicaciones antiguas no tendrán nuevas versiones de !FreedomBox, ni siquiera mediante ''backports''. +Si decides permanecer en una publicación anterior deberías mirar las páginas [[https://www.debian.org/releases/|Debian Releases]] y [[LTS|Long Term Support]] para ver cuánto tiempo va a soportarla el equipo de seguridad de Debian. Deja de usar publicaciones anteriores cuando deje de recibir actualizaciones de seguridad. Ten en cuenta que las publicaciones antiguas no tendrán nuevas versiones de !FreedomBox, ni siquiera mediante ''backports'' (salvo en caso de actualización de seguridad). === Actualización manual a la próxima publicación estable === -Para la mayoría de los usuarios se recomienda la autoactualización. Si no obstante quieres realizar la actualización manualmente aquí tienes algunos consejos: +Treinta días tras la publicación de un nuevo Debian estable, se actualizará a todos los usuarios a la siguiente publicación estable. Este comportamiento se puede desactivar como se describe arriba ya que algunos usuarios podrían preferir agendar su actualización por los siguientes motivos: + * Si no quieres esperar 30 días y quieres obtener la última publicación inmediatamente. + * Si quieres mantener tu instalación funcional estable y no arriesgarte a cambiarla (los cambios grandes de sistemas operativos conllevan cierto riesgo). Podrías mantener tu distribución sin cambios durante años. + * Si quieres minimizar la disrupción asociada al proceso de actualización eligiendo el momento adecuado. + * Si tus aplicaciones favoritas ya no se soportan en la nueva publicación estable y necesitas tiempo para migrar a otra alternativa. + * Si quieres hacer copias de respaldo completas antes de actualizar la publicación y estar al tanto para restaurarlas si algo fuera mal. + * Si quieres probar el proceso de actualización antes de otros usuarios e informar de problemas al equipo de desarrollo. -General: - * Toma una instantánea del sistema antes de empezar. - * Hay disponibles [[DebianUpgrade|instrucciones]] generales para actualizar la distributción Debian. - * Se sabe que algunos paquetes preguntan al usuario durante la actualización debido a cambios en los ficheros conf. Se recomienda no actualizar estos paquetes manualmente, sino permitir que !FreedomBox trate sus actualizaciones automaticamente. Nos referimos a los siguientes paquetes: - * firewalld - * minidlna - * radicale +Para la mayoría de los usuarios se recomienda la autoactualización. Si no obstante quieres realizar la actualización manualmente aquí tienes algunos consejos: + * Toma una instantánea del sistema antes de empezar. Copiar el disco entero mediante algún software de clonado sería aún mejor. + * Hay disponibles [[DebianUpgrade|instrucciones]] generales para actualizar la distribución Debian pero no incluyen los cambios en la configuración necesarios para las nuevas versiones de software. + * Algún software podría requerir operaciones de actualización adicionales que !FreedomBox ejecutaría al arrancar tras una actualización de publicación. Por favor, espere a que !FreedomBox complete esas operaciones tras una actualización de publicación. He aquí algunas aplicaciones con estos requisitos: + * Postfix/Dovecot (requiere un nuevo formato en su fichero de configuración) + * !MediaWiki (requiere una actualización de la base de datos) + * Se sabe que algunos paquetes preguntan al usuario durante la actualización debido a cambios en los ficheros de configuración. Se recomienda no actualizar estos paquetes manualmente, sino permitir que !FreedomBox trate sus actualizaciones automáticamente. Nos referimos a los siguientes paquetes: + * Firewalld + * Minidlna + * Radicale + +Algunos paquetes podrían no estar disponibles tras una actualización de publicación. Por favor, migra a una aplicación similar. Al actualizar a Debian 13 "trixie", las siguentes aplicaciones dejan de estar disponibles: + * Janus. Usa Matrix o XMPP para llamadas de video o Mumble para audio. Esta app probáblemente vuelva a estar disponible en el futuro. + * TT-RSS. Migra a Miniflux. + * Searx. + +Para iniciar el proceso de actualización de publicación, ve a ''Actualización de Software'' en la sección ''Sistema''. Luego ''Habilitar autoactualización'' y la opción ''Habilitar autoactualización a la siguiente publicación estable''. Entonces haz clic en el botón ''Actualización de Distibución''. Y luego en ''Iniciar Actualización de Distibución''. El proceso podría llegar varias horas si tu sistema operativo reside en un almacenamiento lento como una tarjeta SD. El interfaz web de !FreedomBox podría estar indisponible durante la actualización. Refresca la página si muestra errores. Finalmente, espera a los procesos de post-actualización y reinicia la máquina. + +{{attachment:FreedomBox/Manual/Upgrades/distribution-update.png}} ## END_INCLUDE diff --git a/doc/manual/es/freedombox-manual.raw.wiki b/doc/manual/es/freedombox-manual.raw.wiki index a4855fea7..a7ace4e45 100644 --- a/doc/manual/es/freedombox-manual.raw.wiki +++ b/doc/manual/es/freedombox-manual.raw.wiki @@ -26,6 +26,7 @@ <> <> <> +<> <> <> <> @@ -77,6 +78,9 @@ <> <> += Guías = +<> + = Hardware = <> <> diff --git a/doc/manual/es/images/cubieboard2_thumb.jpg b/doc/manual/es/images/cubieboard2_thumb.jpg index 5f9eab185..fe77bd519 100644 Binary files a/doc/manual/es/images/cubieboard2_thumb.jpg and b/doc/manual/es/images/cubieboard2_thumb.jpg differ diff --git a/doc/manual/es/images/distribution-update.png b/doc/manual/es/images/distribution-update.png new file mode 100644 index 000000000..112046596 Binary files /dev/null and b/doc/manual/es/images/distribution-update.png differ diff --git a/doc/manual/es/images/kiwix-tile.png b/doc/manual/es/images/kiwix-tile.png new file mode 100644 index 000000000..9e27693e3 Binary files /dev/null and b/doc/manual/es/images/kiwix-tile.png differ diff --git a/doc/manual/es/images/ui_firstboot_feature_updates.png b/doc/manual/es/images/ui_firstboot_feature_updates.png new file mode 100644 index 000000000..f4dfcff9a Binary files /dev/null and b/doc/manual/es/images/ui_firstboot_feature_updates.png differ