doc: Fetch latest manual

Signed-off-by: James Valleroy <jvalleroy@mailbox.org>
This commit is contained in:
James Valleroy 2021-08-16 19:18:13 -04:00
parent 62dbad5694
commit 7159e2f735
No known key found for this signature in database
GPG Key ID: 77C0C75E7B650808
35 changed files with 314 additions and 37 deletions

View File

@ -15,10 +15,11 @@ From code, design and translation to spreading the word and donation, here are a
== Quick Links ==
[[https://docs.freedombox.org/|FreedomBox Developer Manual]] <<BR>>
[[FreedomBox/ProgressCalls|Progress calls]] <<BR>>
[[FreedomBox/TODO|TODO page]] <<BR>>
[[https://www.freedomboxfoundation.org/donate/|Donation page]] <<BR>>
* [[FreedomBox/Vision|Our vision]] explains what we want to achieve.
* [[https://docs.freedombox.org/|FreedomBox Developer Manual]]
* [[FreedomBox/ProgressCalls|Progress calls]]
* [[FreedomBox/TODO|TODO page]]
* [[https://www.freedomboxfoundation.org/donate/|Donation page]]
== Welcome to newcomers ==
@ -78,7 +79,7 @@ If you wish to see !FreedomBox available for one of your languages, please start
For more information, please visit the !FreedomBox [[FreedomBox/Translate|translators]] page.
== Document: User Manual, Website and Wiki ==
== Document: User Manual, Website and Wiki, HowTo/demo videos ==
!FreedomBox needs better documentation for users and contributors. Sometimes, just rewording or presenting the information another way, already helps. Others, a certain knowledge is needed.
@ -88,6 +89,7 @@ If you wish to contribute to the !FreedomBox [[FreedomBox|wiki]] (and consequent
For contributing to the website please start a discussion on the !FreedomBox discussion forum's [[https://discuss.freedombox.org/c/development|development category]].
Another way of documenting !FreedomBox is to record and publish screencasts showing how to use it, or videos on why to use it. Like [[https://peertube.debian.social/search?search=freedombox&searchTarget=local|these]] or [[https://www.youtube.com/results?search_query=freedombox|these]].
== Assure Quality (Test and Check) ==

View File

@ -10,7 +10,7 @@
!FreedomBox is a [[DebianPureBlends|pure blend]] of Debian. This means that all the work on !FreedomBox is available in Debian as packages. It also means that any machine running Debian can be turned into a !FreedomBox.
This page describes the process of installing !FreedomBox on a Debian system. Currently, !FreedomBox works in Debian Stable (Buster), Testing (Bullseye), and Unstable (Sid).
This page describes the process of installing !FreedomBox on a Debian system. Currently, !FreedomBox works in Debian Stable (Bullseye), Testing (Bookworm), and Unstable (Sid).
'''Important:''' Read [[FreedomBox/Hardware|general advice]] about hardware before building a !FreedomBox with this approach.
@ -26,11 +26,11 @@ Installing !FreedomBox changes your Debian system in many important ways. This
After !FreedomBox is fully setup, your system will no longer allow users not belonging to the ''admin'' group to log in to the system via console, secure shell (SSH) or graphical login. This behaviour can be disabled from the [[FreedomBox/Manual/Security|Security]] page. Use the administrator account created during !FreedomBox first boot for console logins and add further user accounts to ''admin'' group, if necessary.
}}}
=== Installing on Debian 10.0 (Buster) or newer ===
=== Installing on Debian 11 (Bullseye) or newer ===
Check the Troubleshooting section below, for any tips or workarounds that might help during the install.
1. [[InstallingDebianOn|Install Debian]] 10.0 (Buster), or Unstable (Sid) on your hardware.
1. [[InstallingDebianOn|Install Debian]] 11 (Bullseye), or Unstable (Sid) on your hardware.
1. Update your package list.
@ -59,7 +59,7 @@ auto lo
iface lo inet loopback
}}}
If you have already completed the setup process without doing this step, you will need to clear out the `/etc/network/interfaces` file keeping only the above lines. Then perform a reboot. On Debian 9 (Stretch), after this network connections configured by the `setup` step above will configure your network. Network interfaces will then be in the `internal` or `external` firewall zone. This is essential for the !FreedomBox's web interface to be reachable from other machines in the network. You can tweak network manager connections with the `nmtui` command if you wish.
If you have already completed the setup process without doing this step, you will need to clear out the `/etc/network/interfaces` file keeping only the above lines. Then perform a reboot. Network interfaces will then be in the `internal` or `external` firewall zone. This is essential for the !FreedomBox's web interface to be reachable from other machines in the network. You can tweak network manager connections with the `nmtui` command if you wish.
1. !FreedomBox will use an automatically configured IP address by default. You can assign a static IP address if necessary. Network configuration changes can be done using !FreedomBox web interface or by using the `nmtui` or `nmcli` commands. `nmcli` can be used as follows:

View File

@ -12,7 +12,7 @@
=== Availability ===
* [[https://www.aliexpress.com/store/group/H2/1553371_511831299.html|AliExpress]]
* [[https://www.aliexpress.com/store/group/Allwinner-H2/1553371_516093180.html|AliExpress]]
=== Hardware ===

View File

@ -9,7 +9,7 @@
=== Similar Hardware ===
* Both 1GB and 2GB versions of Pine A64+ are supported with the same !FreedomBox image.
* Pine A64-LTS is not supported yet.
* There is a separate [[https://freedombox.org/download/pine-a64-lts/|Pine A64-LTS image]].
=== Download ===

View File

@ -10,6 +10,18 @@ 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.7 (2021-08-16) ==
=== Highlights ===
* ttrss: Allow upgrade to version 21
=== Other Changes ===
* locale: Update translations for Albanian, Bengali, Chinese (Simplified), German, Indonesian, Norwegian Bokmål, Ukrainian, Vietnamese
* action_utils: Use flag to indicate freedombox package has been held
* debian: Ensure fuse gets replaced by fuse3
== FreedomBox 21.6 (2021-05-31) ==
=== Highlights ===

View File

@ -10,7 +10,7 @@ Pine64's [[https://www.pine64.org/rockpro64/|RockPro64]] is a powerful single bo
Before downloading and using !FreedomBox you need to ensure that latest u-boot based firmware is installed into the SPI flash chip. See instructions on how to [[https://github.com/sigmaris/u-boot/wiki/Flashing-U-Boot-to-SPI|write u-boot firmware into SPI flash]]. The gist is that you download and write an image to an SD card. Boot with SD card and wait for white LED blinking to stop. After that power off, remove the SD card and proceed with !FreedomBox download.
!FreedomBox [[FreedomBox/Download|images]] meant for all "arm64" hardware work well for this device. However, u-boot firmware must present in SPI flash (or on a separate SD card, which is not explained here). Follow the instructions on the [[FreedomBox/Download|download]] page to create a !FreedomBox SD card and boot the device. These images also work well for USB 2.0 and USB 3.0 disk drives and the process for preparing them is same as for an SD card.
!FreedomBox [[FreedomBox/Download|images]] meant for all "arm64" hardware work well for this device. However, u-boot firmware must be present in SPI flash (or on a separate SD card, which is not explained here). Follow the instructions on the [[FreedomBox/Download|download]] page to create a !FreedomBox SD card and boot the device. These images also work well for USB 2.0 and USB 3.0 disk drives and the process for preparing them is same as for an SD card.
An alternative to downloading these images is to [[InstallingDebianOn|install Debian]] on the device and then [[FreedomBox/Hardware/Debian|install FreedomBox]] on it.
@ -39,7 +39,7 @@ An alternative to downloading these images is to [[InstallingDebianOn|install De
=== Known Issues ===
* !FreedomBox does not work when booted from eMMC module (but works from SD card, USB 2.0 disk or USB 3.0 disk). !FreedomBox on NMVe disk has not been tested.
* !FreedomBox does not work when booted from eMMC module (but works from SD card, USB 2.0 disk or USB 3.0 disk). !FreedomBox on NVMe disk has not been tested.
## END_INCLUDE

View File

@ -55,14 +55,38 @@ Password: <enter user password here>
# apt update
}}}
If `apt-get update` asks for a confirmation to change ''Codename'' or other release information, confirm ''yes''. If during update of ''freedombox'' package, if a question about overwriting configuration files is asked, answer to install new configuration files from the latest version of the package. This process will upgrade only packages that don't require configuration file questions (except for ''freedombox'' package). After this, let !FreedomBox handle the upgrade of remaining packages. Be patient while new releases of !FreedomBox are made to handle packages that require manual intervention.
If `apt update` asks for a confirmation to change ''Codename'' or other release information, confirm ''yes''. If during update of ''freedombox'' package, if a question about overwriting configuration files is asked, answer to install new configuration files from the latest version of the package. This process will upgrade only packages that don't require configuration file questions (except for ''freedombox'' package). After this, let !FreedomBox handle the upgrade of remaining packages. Be patient while new releases of !FreedomBox are made to handle packages that require manual intervention.
If you want to go beyond the recommendation to upgrade all the packages on your !FreedomBox and if you are really sure about handling the configuration changes for packages yourself, run the following command:
{{{
$ apt dist-upgrade
$ 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.
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.
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.
=== 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:
General:
* Create a system snapshot before you begin.
* Consider placing a temporary hold (using `apt-mark`) on the freedombox package, to prevent its removal when other packages are being updated. Remember to remove the hold later, so that `freedombox` package can be updated.
Updating from Debian 10 (Buster) to Debian 11 (Bullseye):
* If Searx is installed, after the package is updated, you will need to update its list of search engines.
* You may need to configure `grub-pc` package (using `dpkg-reconfigure`) so that it does not require to install `grub` again.
* You may need to remove the obsolete package `libgcc1`.
* Consider placing temporary holds on the following packages, and let !FreedomBox handle updating them later:
* `firewalld`, `mumble-server`, `radicale`, `roundcube-core`, `tt-rss`
## END_INCLUDE
Back to [[FreedomBox/Features|Features introduction]] or [[FreedomBox/Manual|manual]] pages.

View File

@ -0,0 +1,85 @@
#language en
##TAG:TRANSLATION-HEADER-START
~- [[FreedomBox/Manual/WordPress|English]] - [[es/FreedomBox/Manual/WordPress|Español]] - [[DebianWiki/EditorGuide#translation|(+)]] -~
##TAG:TRANSLATION-HEADER-END
<<TableOfContents()>>
## BEGIN_INCLUDE
== WordPress (Website and Blog) ==
||<tablestyle="float: right;"> {{attachment:WordPress-icon_en_V01.png|WordPress icon}} ||
'''Available since''': version 21.7
=== What is WordPress? ===
!WordPress is a popular way to create and manage websites and blogs. It is a content management system that allows editing content using a visual web-based interface. No knowledge of HTML or other markup is needed to create websites. Complete layout and functionality of the web pages can be customized. Appearance can be chosen using themes. Administration interface and produced web pages are suitable for mobile devices.
{{attachment:wordpress-site.png|A Simple Site}}
{{attachment:wordpress-edit.png|Content Editing Interface}}
{{attachment:wordpress-admin.png|Administration Interface}}
=== Setting up WordPress on FreedomBox ===
To setup !WordPress, navigate to the !WordPress (Website and Blog) page and install it. !WordPress needs a valid domain name to be configured. Before proceeding further, setup a proper domain name. Domains are configured using [[FreedomBox/Manual/Configure|System -> Configure]] page. Access your !FreedomBox web interface using the domain you have configured. After this, visit the !WordPress web interface. This will show a setup page asking for the name of the site and details for a new administrator account. After this step, !WordPress is fully configured and ready. You can then return to the !FreedomBox's !WordPress app page and optionally make the !WordPress installation available to public.
{{attachment:wordpress-setup.png|Initial Setup Page}}
=== Public Access ===
In the !WordPress app page in !FreedomBox, the app can be made publicly available. It is, by default, not publicly available. It is only available to users who login as administrators in !FreedomBox interface. This is to protect the initial setup process from becoming publicly available. If the setup process is publicly available, any visitor will be able to create themselves an administrator account which is undesirable. Administrators must take care not to enable public access until !WordPress' setup process has been completed.
=== Users ===
At the moment, !WordPress has its own user accounts that are unrelated to !FreedomBox accounts. The first account created during the setup process is an administrator account. After logging in with the administrator account, separate accounts for viewing, publishing, or administering may be created from within !WordPress interface.
Changes to content and configuration of !WordPress can only be done after logging into !WordPress. However, by default, there is no link from the website or blog to reach the login page. Bookmark or directly type into the browser '''https://<mydomainname>/wordpress/wp-admin/''' to reach administration interface.
=== WordPress as Home Page ===
A beautiful, well customized !WordPress website can be set as the home page for your !FreedomBox. This can be done in [[FreedomBox/Manual/Configure|System -> Configure]] page of the !FreedomBox web interface. For example, if your !FreedomBox's domain name is myfreedombox.rocks and you set !WordPress as the home page, visiting https://myfreedombox.rocks will take you to https://myfreedombox.rocks/wordpress/ instead of the !FreedomBox interface.
=== Domain Name ===
When !WordPress is setup for the first time, the domain name through which you access it is noted and !WordPress gets configured with that domain name. Be sure to setup your domain name properly and access the !WordPress setup process using the domain name and not a local IP address or domain name. Currently, !FreedomBox does not provide an easy way to change the domain name once the app is installed.
=== Permalinks ===
By default, web addresses for newly created blog posts and pages look like '''/wordpress/?p=1'''. They can be made to look prettier like '''/wordpress/2021/08/06/sample-post/''' instead. This can be done from the ''Settings -> Permalinks'' configuration page in !WordPress interface. The necessary web server configuration changes are handled by !FreedomBox during app installation.
{{attachment:wordpress-permalinks.png|Enabling Permalinks}}
=== Automatic Upgrades ===
Similar to all other apps, feature and security upgrades for !WordPress are automatically handled by !FreedomBox (when not disabled). After a minor version upgrade, changes to the database structure are automatically done by !WordPress. However, after a major version upgrade, such as during major distribution upgrade every two years, database changes are not done automatically. For this, you need to login to !WordPress and trigger the changes manually.
=== Plugins and Themes ===
!WordPress in itself is quite powerful and sufficient to create and manage a simple website or blog. It's true power, however, lies in the thousands of plugins and themes. Plugins extend the functionality of !WordPress. For example, a contact form can be added to !WordPress by installing the appropriate plugin. Themes change the appearance and layout of the site. Installing a new theme will provide an extra administration option for how your site will appear to your visitors.
Since there are few plugins/themes packaged for Debian, !FreedomBox does not provide a simple way to install and manage them. You need to install them manually. This can be done as follows:
1. Note the URL of the plugin or theme to download by browsing them from !WordPress administration interface or the official website. Be sure to select trustworthy ones with a free software license.
1. Log in via SSH using a !FreedomBox administrator account.
1. Download the plugin or theme and unpack into a directory using the command line.
1. Move the directory under '''/var/lib/wordpress/wp-content/plugins/''' or '''/var/lib/wordpress/wp-content/themes/''' as appropriate.
1. Watch for upgrades to these plugins from !WordPress and repeat the process for installing newer versions.
=== External links ===
* !WordPress website: https://wordpress.org
* Discover !WordPress plugins: https://wordpress.org/plugins/
* Explore !WordPress themes: https://wordpress.org/themes/
* !WordPress documentation: https://wordpress.org/support/
## END_INCLUDE
Back to [[FreedomBox/Features|Features introduction]] or [[FreedomBox/Manual|manual]] pages.
<<Include(FreedomBox/Portal)>>
----
CategoryFreedomBox

View File

@ -55,14 +55,18 @@ Currently, all users created through !FreedomBox will be able to login to the XM
If your !FreedomBox is behind a router, you will need to set up port forwarding on your router. You should forward the following ports for XMPP:
* TCP 5222 (client-to-server)
* TCP 5269 (server-to-server)
* TCP 5280 (?)
=== Compatible clients ===
* !FreedomBox provides a web client: [[FreedomBox/Manual/JSXC|JSXC]].
* [[https://xmpp.org/software/clients.html|XMPP clients]] are available for various desktop and mobile platforms. !FreedomBox links to the download sources of some of them. Feel free to include more [[https://wiki.debian.org/FreedomBox/Manual/ejabberd?action=edit&editor=text|here]] (needs free registration). We'll notice and might list them in !FreedomBox.
{{attachment:xmpp-clients_en_V01.png|XMPP clients}}
{{attachment:xmpp-clients_en_V01.png|XMPP clients}}
==== FreedomBox webclient ====
For maximum simplicity !FreedomBox provides a web client: [[FreedomBox/Manual/JSXC|JSXC]]. No need for your users to install additional software on their side. They'll be able to just use their browser. This is usually the first choice for new and eventual users.
==== Mobile clients ====
@ -136,10 +140,11 @@ Once you have logged in, you will be able to either start a conversation with on
=== External links ===
==== Ejabberd ====
* Website: https://www.ejabberd.im
* User documentation: https://docs.ejabberd.im
Clients' sites:
==== Clients' sites ====
* Conversations: https://conversations.im
* Gajim: https://gajim.org
* Dino: https://github.com/dino/dino
@ -148,6 +153,9 @@ Clients' sites:
* Monal: https://monal.im
* Siskin: https://siskin.im
==== XMPP Protocol ====
* Website: https://xmpp.org
* Summary at Wikipedia: https://en.wikipedia.org/wiki/XMPP
## END_INCLUDE

View File

@ -47,6 +47,7 @@
<<Include(FreedomBox/Manual/Transmission, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
<<Include(FreedomBox/Manual/Apache_userdir, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
<<Include(FreedomBox/Manual/WireGuard, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
<<Include(FreedomBox/Manual/WordPress, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
<<Include(FreedomBox/Manual/Zoph, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
= System =

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 83 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 117 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

View File

@ -12,6 +12,21 @@ Actualmente en !FreedomBox BIND solo se usa para resolver consultas DNS de otras
Nota: Este servicio solo está disponible en redes configuradas como zona "interna". Tampoco está disponble a través de OpenVPN (es incompatible).
=== Usar BIND ===
Habilitar BIND no implica que automáticamente se use en todas partes. Se puede configurar lo siguiente:
* !FreedomBox se puede configurar para usar el servicio BIND local para sus propias consultas DNS.
* Los clientes de la red de área local (LAN) se pueden configurar para usar el servicio BIND de !FreedomBox's para sus consultas DNS.
Se puede configurar !FreedomBox para usar su propio servicio BIND local para sus consultas DNS en [[es/FreedomBox/Manual/Networks|Redes]]:
1. Ir a la página ''Sistema'' y seleccionar ''Redes''.
1. Seleccionar la conexión "!FreedomBox WAN" y pulsar ''Editar''.
1. Debajo de "Métodos de direccionado IPv4" hay un campo "Servidor DNS". Establecerlo a {{{127.0.0.1}}}.
/* TODO: Add IPv6 instructions. */
1. Pulsar "Editar conexión" abajo para grabar los cambios.
1. Reiniciar la !FreedomBox desde el menú desplegable de usuario.
/* TODO: Add instructions for serving clients on LAN. */
=== Enlaces externos ===

View File

@ -13,10 +13,11 @@ Desde la codificación, el diseño y la traducción hasta la divulgación y las
== Enlaces Rápidos ==
[[https://docs.freedombox.org/|Manual del Desarrollador de FreedomBox]] <<BR>>
[[FreedomBox/ProgressCalls|Reuniones de revisión de avance]] <<BR>>
[[FreedomBox/TODO|Página de trabajos pendientes]] <<BR>>
[[https://www.freedomboxfoundation.org/donate/|Página de Donaciones]]<<BR>>
* [[es/FreedomBox/Vision|Nuestra visión]] explica lo que queremos lograr.
* [[https://docs.freedombox.org/|Manual del Desarrollador de FreedomBox]]
* [[FreedomBox/ProgressCalls|Reuniones de revisión de avance]]
* [[FreedomBox/TODO|Página de trabajos pendientes]]
* [[https://www.freedomboxfoundation.org/donate/|Página de Donaciones]]
== Bienvenida a los recién llegados ==
@ -79,7 +80,7 @@ Si quieres ver a !FreedomBox disponible en alguno de tus idiomas, por favor abre
Para más información, por favor visita la página de [[FreedomBox/Translate|traductores]].
== Documentar: Manual de Usuario, Sitio Web y Wiki ==
== Documentar: Manual de Usuario, Sitio Web y Wiki, Vieos demostrativos ==
!FreedomBox necesita mejor documentación para usuarios y contribuyentes. A veces re-redactar o presentar la información de otra manera ya ayuda. Otras se necesita cierto conocimiento.
@ -89,6 +90,7 @@ Si quieres contribuir al [[es/FreedomBox|wiki]] (y por extensión al manual) de
Para contribuir al sitio web por favor inicia un debate en la [[https://discuss.freedombox.org/c/development|sección de desarrollo]] del foro de !FreedomBox.
Otra manera de documentar !FreedomBox es grabar y publicar videos de cómo y/o por qué usarlo. Comno [[https://peertube.debian.social/search?search=freedombox&searchTarget=local|estos]] o [[https://www.youtube.com/results?search_query=freedombox|estos]].
== Asegurar la calidad (probar y comprobar) ==

View File

@ -10,7 +10,7 @@
!FreedomBox is a [[DebianPureBlends|pure blend]] of Debian. This means that all the work on !FreedomBox is available in Debian as packages. It also means that any machine running Debian can be turned into a !FreedomBox.
This page describes the process of installing !FreedomBox on a Debian system. Currently, !FreedomBox works in Debian Stable (Buster), Testing (Bullseye), and Unstable (Sid).
This page describes the process of installing !FreedomBox on a Debian system. Currently, !FreedomBox works in Debian Stable (Bullseye), Testing (Bookworm), and Unstable (Sid).
'''Important:''' Read [[FreedomBox/Hardware|general advice]] about hardware before building a !FreedomBox with this approach.
@ -26,11 +26,11 @@ Installing !FreedomBox changes your Debian system in many important ways. This
After !FreedomBox is fully setup, your system will no longer allow users not belonging to the ''admin'' group to log in to the system via console, secure shell (SSH) or graphical login. This behaviour can be disabled from the [[FreedomBox/Manual/Security|Security]] page. Use the administrator account created during !FreedomBox first boot for console logins and add further user accounts to ''admin'' group, if necessary.
}}}
=== Installing on Debian 10.0 (Buster) or newer ===
=== Installing on Debian 11 (Bullseye) or newer ===
Check the Troubleshooting section below, for any tips or workarounds that might help during the install.
1. [[InstallingDebianOn|Install Debian]] 10.0 (Buster), or Unstable (Sid) on your hardware.
1. [[InstallingDebianOn|Install Debian]] 11 (Bullseye), or Unstable (Sid) on your hardware.
1. Update your package list.
@ -59,7 +59,7 @@ auto lo
iface lo inet loopback
}}}
If you have already completed the setup process without doing this step, you will need to clear out the `/etc/network/interfaces` file keeping only the above lines. Then perform a reboot. On Debian 9 (Stretch), after this network connections configured by the `setup` step above will configure your network. Network interfaces will then be in the `internal` or `external` firewall zone. This is essential for the !FreedomBox's web interface to be reachable from other machines in the network. You can tweak network manager connections with the `nmtui` command if you wish.
If you have already completed the setup process without doing this step, you will need to clear out the `/etc/network/interfaces` file keeping only the above lines. Then perform a reboot. Network interfaces will then be in the `internal` or `external` firewall zone. This is essential for the !FreedomBox's web interface to be reachable from other machines in the network. You can tweak network manager connections with the `nmtui` command if you wish.
1. !FreedomBox will use an automatically configured IP address by default. You can assign a static IP address if necessary. Network configuration changes can be done using !FreedomBox web interface or by using the `nmtui` or `nmcli` commands. `nmcli` can be used as follows:

View File

@ -47,6 +47,7 @@
<<Include(FreedomBox/Manual/Transmission, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
<<Include(FreedomBox/Manual/Apache_userdir, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
<<Include(FreedomBox/Manual/WireGuard, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
<<Include(FreedomBox/Manual/WordPress, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
<<Include(FreedomBox/Manual/Zoph, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
= System =

View File

@ -12,7 +12,7 @@
=== Availability ===
* [[https://www.aliexpress.com/store/group/H2/1553371_511831299.html|AliExpress]]
* [[https://www.aliexpress.com/store/group/Allwinner-H2/1553371_516093180.html|AliExpress]]
=== Hardware ===

View File

@ -9,7 +9,7 @@
=== Similar Hardware ===
* Both 1GB and 2GB versions of Pine A64+ are supported with the same !FreedomBox image.
* Pine A64-LTS is not supported yet.
* There is a separate [[https://freedombox.org/download/pine-a64-lts/|Pine A64-LTS image]].
=== Download ===

View File

@ -21,7 +21,6 @@ Alternativamente podrías optar por montarlo tu mismo reuniendo todas las piezas
1. Enciende la !FreedomBox.
* '''Nota:''' En la mayoría de computadoras monoplaca no esperes un efecto de salida en un monitor si lo conectas por HDMI porque el núcleo (kernel) del sistema podría no reconocerlo. Mira más abajo para aprender cómo acceder y controlar tu !FreedomBox desde la red.
1. En el primer arranque !FreedomBox ejecutará su configuración inicial (las versiones más antiguas de !FreedomBox se reinician tras este paso). Este proceso podría llevar varios minutos en algunas máquinas. Después de darle unos 10 minutos aproximadamente, sigue con el siguiente paso.
* '''Nota:''' Esta espera y reinicio se necesitan a causa de un defecto conocido. /* esto está probablemente obsoleto */
1. Después de que tu !FreedomBox haya finalizado su configuración inicial puedes acceder a su interfaz web mediante tu navegador web.
* Si tu ordenador está conectado directamente a tu !FreedomBox a través de un segundo puerto ''Ethernet'' de la red local, puedes navegar a http://freedombox/ o a http://10.42.0.1/.
* Si tu ordenador soporta mDNS (GNU/Linux, Mac OSX o Windows con software mDNS instalado), puedes navegar a: http://freedombox.local/ (o a http://<el-hostname-que-estableciste-durante-la-instalación>.local/)

View File

@ -10,6 +10,18 @@ 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.7 (2021-08-16) ==
=== Highlights ===
* ttrss: Allow upgrade to version 21
=== Other Changes ===
* locale: Update translations for Albanian, Bengali, Chinese (Simplified), German, Indonesian, Norwegian Bokmål, Ukrainian, Vietnamese
* action_utils: Use flag to indicate freedombox package has been held
* debian: Ensure fuse gets replaced by fuse3
== FreedomBox 21.6 (2021-05-31) ==
=== Highlights ===

View File

@ -10,7 +10,7 @@ Pine64's [[https://www.pine64.org/rockpro64/|RockPro64]] is a powerful single bo
Before downloading and using !FreedomBox you need to ensure that latest u-boot based firmware is installed into the SPI flash chip. See instructions on how to [[https://github.com/sigmaris/u-boot/wiki/Flashing-U-Boot-to-SPI|write u-boot firmware into SPI flash]]. The gist is that you download and write an image to an SD card. Boot with SD card and wait for white LED blinking to stop. After that power off, remove the SD card and proceed with !FreedomBox download.
!FreedomBox [[FreedomBox/Download|images]] meant for all "arm64" hardware work well for this device. However, u-boot firmware must present in SPI flash (or on a separate SD card, which is not explained here). Follow the instructions on the [[FreedomBox/Download|download]] page to create a !FreedomBox SD card and boot the device. These images also work well for USB 2.0 and USB 3.0 disk drives and the process for preparing them is same as for an SD card.
!FreedomBox [[FreedomBox/Download|images]] meant for all "arm64" hardware work well for this device. However, u-boot firmware must be present in SPI flash (or on a separate SD card, which is not explained here). Follow the instructions on the [[FreedomBox/Download|download]] page to create a !FreedomBox SD card and boot the device. These images also work well for USB 2.0 and USB 3.0 disk drives and the process for preparing them is same as for an SD card.
An alternative to downloading these images is to [[InstallingDebianOn|install Debian]] on the device and then [[FreedomBox/Hardware/Debian|install FreedomBox]] on it.
@ -39,7 +39,7 @@ An alternative to downloading these images is to [[InstallingDebianOn|install De
=== Known Issues ===
* !FreedomBox does not work when booted from eMMC module (but works from SD card, USB 2.0 disk or USB 3.0 disk). !FreedomBox on NMVe disk has not been tested.
* !FreedomBox does not work when booted from eMMC module (but works from SD card, USB 2.0 disk or USB 3.0 disk). !FreedomBox on NVMe disk has not been tested.
## END_INCLUDE

View File

@ -43,16 +43,40 @@ Password: <introduce la contraseña aquí>
# apt update
}}}
Si `apt-get update` te pide confirmación para algo responde que ''Sí''. Si durante la actualización del paquete `freedombox` te pregunta acerca de los archivos de configuración responde que instale los archivos de configuración nuevos que vienen con la última versión del paquete. Este proceso solo actualizará los paquetes que no necesitan preguntar (excepto el paquete `freedombox`). Después, deja que !FreedomBox se encargue de la actualización de los demás paquetes. Sé paciente mientras se crean nuevas versiones de !FreedomBox para tratar los paquetes que necesitan intervención manual.
Si `apt update` te pide confirmación para algo responde que ''Sí''. Si durante la actualización del paquete `freedombox` te pregunta acerca de los archivos de configuración responde que instale los archivos de configuración nuevos que vienen con la última versión del paquete. Este proceso solo actualizará los paquetes que no necesitan preguntar (excepto el paquete `freedombox`). Después, deja que !FreedomBox se encargue de la actualización de los demás paquetes. Sé paciente mientras se crean nuevas versiones de !FreedomBox para tratar los paquetes que necesitan intervención manual.
Si quieres ir más allá de la recomendación e instalar todos los paquetes en tu !FreedomBox y realmente estás muy seguro de poder tratar los cambios de configuración de paquetes por tí mismo, ejecuta el siguiente comando:
{{{
$ apt dist-upgrade
$ 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.
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''.
=== 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:
General:
* Toma una instantánea del sistema antes de empezar.
* Considera retener provisionalmente el paquete `freedombox` (mediante `apt-mark`) para evitar que se elimine al actualizar otros paquetes. Recuerda quitar la retención cuando termines para que se pueda actualizar el paquete `freedombox`.
Actualizar desde Debian 10 (Buster) a Debian 11 (Bullseye):
* Si Searx está instalado, tras su actualización tendrás que actualizar su lista de motores de búsqueda.
* Quizá tengas que configurar el paquete `grub-pc` (mediante `dpkg-reconfigure`) para que no requiera reinstalar grub.
* Quizá tengas que eliminar el paquete obsoleto `libgcc1`.
* Considera retener provisionalmente los siguientes paquetes y dejar que !FreedomBox se encargue luego de actualizarlos:
* `firewalld`, `mumble-server`, `radicale`, `roundcube-core`, `tt-rss`
## END_INCLUDE
Volver a la [[es/FreedomBox/Features|descripción de Funcionalidades]] o a las páginas del [[es/FreedomBox/Manual|manual]].

View File

@ -0,0 +1,83 @@
#language es
<<Include(FreedomBox/Manual/WordPress, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>
<<TableOfContents()>>
## BEGIN_INCLUDE
== WordPress (Sitio Web y Blog) ==
||<tablestyle="float: right;"> {{attachment:FreedomBox/Manual/WordPress/WordPress-icon_en_V01.png|Icono de WordPress}} ||
'''Disponible desde''': version 21.7
=== ¿Qué es WordPress? ===
!WordPress es una manera popular de crear y administrar sitios web y blogs. Es un sistema de gestión de contenidos que permite editar contenidos mediante una interfaz visual web. Para crear sitios web no se necesitan conocimientos de HTML u otro lenguaje de marcado. Se puede personalizar completamente la disposición y funcionalidad de las páginas web. Se puede seleccionar apariencias eligiendo temas. Tanto los interfaces de administración como las páginas web generadas son adecuadas para dispositivos móviles.
{{attachment:FreedomBox/Manual/WordPress/wordpress-site.png|Un sitio simplón}}
{{attachment:FreedomBox/Manual/WordPress/wordpress-edit.png|Interfaz para la edición de contenidos}}
{{attachment:FreedomBox/Manual/WordPress/wordpress-admin.png|Interfaz para administración}}
=== Configurar WordPress en FreedomBox ===
Para configurar !WordPress, navega a la página ''!WordPress (Website and Blog)'' e instálalo. !WordPress necesita configurar un nombre de dominio válido. Anter de avanzar más establece un nombre de dominio en condiciones. Los dominios se configuran en la página [[es/FreedomBox/Manual/Configure|Sistema -> Configurar]]. Accede al interfaz web de tu !FreedomBox mediante el dominio que has configurado. Después visita el interfaz web de !WordPress. Mostrará una página de configuración pidiendo el nombre del sitio y detalles para una nueva cuenta de administrador. Tras este paso !WordPress está completamente configurado y listo. Ya puedes volver a la página de !WordPress en !FreedomBox y publicar tu instalación de !WordPress si quieres.
{{attachment:FreedomBox/Manual/WordPress/wordpress-setup.png|Página de configuración inicial}}
=== Accesso Público ===
En la página de !WordPress de !FreedomBox se puede publicar la app. Por omisión nace privada para proteger el proceso de configuración inicial frente a que cualquiera se cree una cuenta de administrador. Solo está disponible para usuarios que ingresen en el interfaz de !FreedomBox como administradores y estos tienen que cuidar de no activar el acceso público hasta que se haya completado el proceso de configuración inicial de !WordPress'.
=== Usuarios ===
De momento, !WordPress tiene sus propias cuentas de usuario independientes de las de !FreedomBox. La primera cuenta que se crea en el proceso de configuración inicial es de un administrador. Tras ingresar con ella se pueden crear cuentas para ver, publicar, o administrar desde la propia interfaz de !WordPress.
Solo se pueden hacer cambios al contenido y configuración de !WordPress previo ingreso. Sin embargo por omisión no hay enlace desde el sitio web o el blog para llegar a la página de ingreso. Guarda la dirección o teclea directamente en el navegador `https://<mi-nombre-de-dominio>/wordpress/wp-admin/` para llegar a la interfaz de administración.
=== WordPress como página principal ===
Se puede establecer un sitio web !WordPress bonito y bien personalizado como página principal para tu !FreedomBox en la página [[es/FreedomBox/Manual/Configure|Sistema -> Configurar]] de la interfaz web de !FreedomBox. Por ejemplo, si el nombre de dominio de tu !FreedomBox es `mifreedombox.mola` y has establecido !WordPress como su página de inicio, al visitar `https://mifreedombox.mola` te llevará a `https://mifreedombox.mola/wordpress/` en vez de a la interfaz web de !FreedomBox.
=== Nombre de Dominio ===
Cuando se configura !WordPress por primera vez !WordPress toma el nombre de dominio por el que accedes y se configura con él. Asegúrate de establecer el nombre de dominio apropiado y acceder al proceso de configuración inicial de !WordPress ése mismo y no una dirección IP local u otro dominio. De momento !FreedomBox no proporciona una manera fácil de cambiar el dominio una vez se instala la app.
=== Permalinks ===
Por omisión las direcciones web de artículos de blog de nueva creación son como `/wordpress/?p=1` pero se pueden hacer más bonitas como `/wordpress/2021/08/06/sample-post/`. Esto se puede hacer desde la página ''Ajustes -> Permalinks'' de la interfaz de !WordPress. Los cambios de configuración necesarios en el servidor web los hizo ya !FreedomBox durante la instalación de la app.
{{attachment:FreedomBox/Manual/WordPress/wordpress-permalinks.png|Habilitar Permalinks}}
=== Actualizaciones automáticas ===
Como con todas las demás apps, !FreedomBox (si no se deshabilitan) maneja las actualizaciones funcionales y de seguridad para !WordPress automáticamente. Tras una actualización de versión menor !WordPress efectúa automáticamente cambios en la estructura de la base de datos. No obstante, tras una actualización de versión mayor como un salto bianual de distribución los cambios en la base de datos no son automáticos. Para esto necesitarás ingresar a !WordPress y dispararlos manualmente.
=== Plugins y Temas ===
!WordPress es suficientemente potente para crear y administrar por sí mismo un sitio web o blog simple. Sin embargo su verdadero poder reside en los miles de ''plugins'' y temas. Los ''plugins'' extienden la funcionalidad de !WordPress. Por ejemplo, se puede añadir a !WordPress un formulario de contacto instalando el ''plugin'' apropiado. Los temas cambian la apariencia y disposición de los elementos del sitio. Instalar un nuevo tema proporcionará una opción adicional de administración para determinar la apariencia con que se mostrará a tus visitantes.
Como hay pocos plugins/temas empaquetados para Debian, !FreedomBox no proporciona una manera simple de instalarlos y administrarlos. Necesitar instalarlos manualmente. Se puede hacer así:
* Anota la URL del ''plugin'' o tema para descargar hojeándolas desde la interfaz de !WordPress o la página oficial. Asegúrate de seleccionar elementos confiables con licencia libre.
* Ingresa mediante SSH usando una cuenta de administrador !FreedomBox.
* Descarga el ''plugin'' o tema y desempaquétalo en un directorio usando la línea de órdenes.
* Mueve el directorio bajo `/var/lib/wordpress/wp-content/plugins/` o `/var/lib/wordpress/wp-content/themes/`, según el caso.
* Vigila las actualizaciones de los ''plugins'' instalados desde !WordPress y repite este procedimiento para instalar versiones nuevas.
=== Enlaces externos ===
* Sitio web de !WordPress: https://wordpress.org
* ''Plugins'' para !WordPress: https://wordpress.org/plugins
* Temas para !WordPress: https://wordpress.org/themes
* Documentación de !WordPress: https://wordpress.org/support
## END_INCLUDE
Volver a la [[es/FreedomBox/Features|descripción de Funcionalidades]] o a las páginas del [[es/FreedomBox/Manual|manual]].
<<Include(es/FreedomBox/Portal)>>
----
CategoryFreedomBox

View File

@ -53,14 +53,17 @@ Actualmente todos los usuarios creados con !FreedomBox podrán ingresar al servi
Si tu !FreedomBox está detrás de un router tendrás que configurar en él la redirección de puertos. Redirije los siguientes puertos de XMPP:
* TCP 5222 (cliente-a-servidor)
* TCP 5269 (servidor-a-servidor)
* TCP 5280 (?)
=== Clientes compatibles ===
* !FreedomBox proporciona un cliente web: [[es/FreedomBox/Manual/JSXC|JSXC]].
* Hay [[https://xmpp.org/software/clients.html|clientes XMPP]] disponibles para varias plataformas de escritorio y móviles. !FreedomBox enlaza a las fuentes de descarga de algunos. Eres libre de incluir más [[https://wiki.debian.org/FreedomBox/Manual/ejabberd?action=edit&editor=text|aquí]] (requiere registro libre). Nosotros lo notaremos y quizá lo listemos en !FreedomBox.
{{attachment:FreedomBox/Manual/ejabberd/xmpp-clients_en_V01.png|clientes XMPP}}
{{attachment:FreedomBox/Manual/ejabberd/xmpp-clients_en_V01.png|clientes XMPP}}
==== Cliente Web de FreedomBox ====
Para máxima facilidad !FreedomBox proporciona un cliente web: [[es/FreedomBox/Manual/JSXC|JSXC]]. Tus usuarios no necesitan instalarse software adicional por su parte. Podrán simplemente usar el navegador. Esta es la opción habitual para usuarios nuevos y eventuales.
==== Clientes para móvil ====
@ -133,10 +136,11 @@ Una vez ingreses podrás comenzar una conversación con algún contacto XMPP o u
=== Enlaces externos ===
==== Ejabberd ====
* Sitio web: https://www.ejabberd.im
* Documentación de uso: https://docs.ejabberd.im
Sitios de aplicaciones cliente:
==== Sitios de aplicaciones cliente ====
* Conversations: https://conversations.im
* Gajim: https://gajim.org
* Dino: https://dino.im
@ -145,6 +149,10 @@ Sitios de aplicaciones cliente:
* Monal: https://monal.im
* Siskin: https://siskin.im
==== Protocolo XMPP ====
* Sitio web: https://xmpp.org
* Resumen en Wikipedia: https://en.wikipedia.org/wiki/XMPP
## END_INCLUDE
Volver a la [[es/FreedomBox/Features|descripción de Funcionalidades]] o a las páginas del [[es/FreedomBox/Manual|manual]].

View File

@ -46,6 +46,7 @@
<<Include(es/FreedomBox/Manual/Transmission, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
<<Include(es/FreedomBox/Manual/Apache_userdir, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
<<Include(es/FreedomBox/Manual/WireGuard, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
<<Include(es/FreedomBox/Manual/WordPress, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
<<Include(es/FreedomBox/Manual/Zoph, , from="## BEGIN_INCLUDE", to="## END_INCLUDE")>>
= Sistema =

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 83 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 117 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB