doc: Fetch latest manual

Signed-off-by: James Valleroy <jvalleroy@mailbox.org>
This commit is contained in:
James Valleroy 2023-07-17 22:01:05 -04:00
parent e5880c3a6e
commit 4232bc1ec2
No known key found for this signature in database
GPG Key ID: 77C0C75E7B650808
6 changed files with 49 additions and 9 deletions

View File

@ -8,6 +8,12 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f
The following are the release notes for each !FreedomBox version.
== FreedomBox 23.13 (2023-07-17) ==
* container: Add support for ARM64 containers
* HACKING: Instructions for macOS on Apple Silicon
* locale: Update translations for German, Spanish, Turkish, Ukrainian
== FreedomBox 23.12 (2023-06-19) ==
=== Highlights ===

View File

@ -14,13 +14,19 @@
=== What is Roundcube? ===
Roundcube is a browser-based multilingual email client with an application-like user interface. Roundcube is using the Internet Message Access Protocol (IMAP) to access e-mail on a remote mail server. It supports MIME to send files, and provides particularly address book, folder management, message searching and spell checking.
Roundcube is a browser-based multilingual email client with an application-like user interface. Roundcube is using the Internet Message Access Protocol (IMAP) to access e-mail on a remote mail server. It supports MIME to send files, and provides particularly address book, folder management, message searching, and spell checking.
Roundcube app can be used in one of the two ways. First way to use Roundcube is as a mail client application for an email account you have elsewhere (other than !FreedomBox). For example, if you have a Riseup or Gmail account you can use Roundcube to read and send emails for those accounts. Second way to use to use Roundcube is as a mail client application for an email account on !FreedomBox. This is possible if an email server app, such as Postfix/Dovecot/Rspamd, is setup and enabled on !FreedomBox. Your mails reside on the !FreedomBox server and Roundcube (or other desktop/mobile mail clients) can be used to read and send mails. At present, Roundcube can only be setup for one of these two ways. This is controlled by the ''Use only the local mail server'' option in Roundcube app configuration page.
Roundcube app can be used to read and send emails in one of the two ways: using an email account you have elsewhere (other than !FreedomBox), like in Riseup or in Gmail, or an account on !FreedomBox. The latter is possible if an email server app, such as [[FreedomBox/Manual/Email|Postfix/Dovecot/Rspamd]], is setup and enabled on !FreedomBox. At present, Roundcube can only be setup for one of these two ways. This is controlled by the ''Use only the local mail server'' option in Roundcube app configuration page.
=== Email privacy ===
In the first case, you only get privacy over your drafts. Once you send the email, a copy will reside in the external services (Riseup, Gmail, etc) unless you explicitly remove it. In any case, your traffic transits through them.
In the second (self-hosted) case, your mail copies reside on your !FreedomBox server. But you only keep privacy as long as the recipient also uses a private system and doesn't disclose your content.
=== Using Roundcube ===
After Roundcube is installed, it can be accessed at {{{https://<your freedombox>/roundcube}}}. Enter your username and password. The username for many mail services will be the full email address such as ''exampleuser@example.org'' and not just the username like ''exampleuser''. Enter the address of your email service's IMAP server address in the ''Server'' field. You can try providing your domain name here such as ''example.org'' for email address ''exampleuser@example.org'' and if this does not work, consult your email provider's documentation for the address of the IMAP server. Using encrypted connection to your IMAP server is strongly recommended. To do this, prepend 'imaps://' at the beginning of your IMAP server address. For example, ''imaps://imap.example.org''.
After Roundcube is installed, it can be accessed at {{{https://<your freedombox>/roundcube}}}. Enter your username and password. The username for many mail services will be the full email address such as ''exampleuser@example.org'' and not just the username like ''exampleuser''. Enter the address of your email service's IMAP server address in the ''Server'' field. You can try providing your domain name here, such as ''example.org'' for email address ''exampleuser@example.org'' and if this does not work, consult your email provider's documentation for the address of the IMAP server. Using encrypted connection to your IMAP server is strongly recommended. To do this, prepend 'imaps://' at the beginning of your IMAP server address. For example, ''imaps://imap.example.org''.
{{attachment:roundcube-riseup.png|Logging into your IMAP server|width=606}}

View File

@ -45,6 +45,8 @@ $ gpg --keyserver keyserver.ubuntu.com --recv-keys BCBEBD57A11F70B23782BC5736C36
$ gpg --keyserver keyserver.ubuntu.com --recv-keys 7D6ADB750F91085589484BE677C0C75E7B650808
# Esta es la clave del servidor de integración contínua de FreedomBox
$ gpg --keyserver keyserver.ubuntu.com --recv-keys 013D86D8BA32EAB4A6691BF85D4153D6FE188FC8
# Esta es la clave del uevo servidor de integración contínua de FreedomBox
$ gpg --keyserver keyserver.ubuntu.com --recv-keys D4B069124FCF43AA1FCD7FBC2ACFC1E15AF82D8C
}}}
* A continuación, verifica la huella de las claves públicas:
{{{
@ -68,17 +70,23 @@ pub rsa4096 2018-06-06 [SC]
013D 86D8 BA32 EAB4 A669 1BF8 5D41 53D6 FE18 8FC8
uid [ unknown] FreedomBox CI (Continuous Integration server) <admin@freedombox.org>
sub rsa4096 2018-06-06 [E]
$ gpg --fingerprint D4B069124FCF43AA1FCD7FBC2ACFC1E15AF82D8C
pub rsa4096 2022-03-09 [SC]
D4B0 6912 4FCF 43AA 1FCD 7FBC 2ACF C1E1 5AF8 2D8C
uid [ unknown] FreedomBox CI (Continuous Integration server) <admin@freedombox.org>
sub rsa4096 2022-03-09 [E]
}}}
* Finalmente, verifica tu imágen descargada con su archivo de firma `.sig`. Por ejemplo:
{{{
$ $ gpg --verify freedombox-stable-free_buster_cubietruck-armhf.img.xz.sig
gpg: assuming signed data in 'freedombox-stable-free_buster_cubietruck-armhf.img.xz'
gpg: Signature made Sat 09 May 2020 11:54:01 AM EDT
gpg: using RSA key 013D86D8BA32EAB4A6691BF85D4153D6FE188FC8
gpg: Good signature from "FreedomBox CI (Continuous Integration server) <admin@freedombox.org>" [undefined]
$ $ gpg --verify freedombox-bookworm_all-amd64.img.xz.sig
gpg: assuming signed data in 'freedombox-bookworm_all-amd64.img.xz'
gpg: Signature made Wed 14 Jun 2023 03:22:04 PM PDT
gpg: using RSA key D4B069124FCF43AA1FCD7FBC2ACFC1E15AF82D8C
gpg: Good signature from "FreedomBox CI (Continuous Integration server) <admin@freedombox.org>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: 013D 86D8 BA32 EAB4 A669 1BF8 5D41 53D6 FE18 8FC8
Primary key fingerprint: D4B0 6912 4FCF 43AA 1FCD 7FBC 2ACF C1E1 5AF8 2D8C
}}}
=== Instalación ===

View File

@ -55,6 +55,12 @@ Alternativamente podrías optar por montarlo tu mismo reuniendo todas las piezas
. {{attachment:ui_insecure_connection-es.png|Aviso de certificado autofirmado|width=600}}
. {{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.
El primer método es acceder a tu !FreedomBox por su dirección IP en vez de por el dominio. Así, en vez de usar algo como https://ejemplo.com usarías algo como https://198.51.100.2 (substituyendo tu priopia dirección IP).
El segundo método es crear un perfil nuevo en tu navegador y acceder a tu !FreedomBox con él. El perfil nuevo no recordará ni el sitio ni el certificado. Una vez tu !FreedomBox tenga su nuevo certificado ''Let's Encrypt'' puedes volver a usar el perfil antiguo en el navegador.
1. La primera vez que accedes al interfaz web de tu !FreedomBox verás una página de bienvenida. Haz clic en el botón "Iniciar configuración" para continuar.
. {{attachment:ui_firstboot_welcome-es.png|Bienvenida|width=500}}

View File

@ -8,6 +8,12 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f
The following are the release notes for each !FreedomBox version.
== FreedomBox 23.13 (2023-07-17) ==
* container: Add support for ARM64 containers
* HACKING: Instructions for macOS on Apple Silicon
* locale: Update translations for German, Spanish, Turkish, Ukrainian
== FreedomBox 23.12 (2023-06-19) ==
=== Highlights ===

View File

@ -15,6 +15,14 @@
Roundcube es un cliente de correo electrónico (''email'') para navegador con un interfaz de usuario parecido a una aplicación de escritorio. Admite varios lenguajes. Roundcube usa el protocolo de acceso a mensajes de Internet (IMAP = ''Internet Message Access Protocol'') para acceder a los correos en un servidor remoto. Soporta MIME para enviar archivos adjuntos y en particular proporciona libreta de contactos, gestión de carpetas, búsquedas de mensajes y verificación ortográfica.
Roundcube se puede usar para leer y enviar correos electrónicos de una de dos maneras: Usando una cuenta de correo alojada fuera de !FreedomBox, como Riseup o Gmail, o bien con una cuenta alojada en !FreedomBox. La segunda es posible si se despliega una app de servidor de correo como [[es/FreedomBox/Manual/Roundcube|Postfix/Dovecot/Rspamd]] en !FreedomBox. Actualmente Roundcube solo se puede configurar en uno de estos modos ('''no''' con ambos coexistiendo). Esto se controla con la opción ''Usar solo el servidor de correo local mail'' de la página de configuración de la app de Roundcube.
=== Privacidad con Correo Electrónico ===
En el primer caso solo obtienes privacidad sobre tus borradores. Una vez envías el correo una copia reside en el servicio externo (Riseup, Gmail, etc), salvo que la borres expresamente. En cualquier caso tu tráfico transita a través de ellos.
En el segundo caso (autoalojando) tu copia del correo reside en tu servidor !FreedomBox. Pero solo mantienes privacidad mientras el destinatario también use un sistema privado y no revele tu contenido.
=== Usar Roundcube ===
Tras instalar Roundcube se puede acceder a él en {{{https://<tu_freedombox>/roundcube}}}. Introduce tu usuario y contraseña. El usuario de muchos servicios de correo electrónico suele ser la propia dirección completa, como ''usuario_de_ejemplo@servicio_de_ejemplo.org'', no solo el usuario ''usuario_de_ejemplo''. Introduce la dirección del servidor IMAP de tu servicio de correo electrónico en el campo ''Servidor''. Puedes probar a poner aquí tu nombre de dominio como ''servicio_de_ejemplo.org'' si la dirección es ''usuario_de_ejemplo@servicio_de_ejemplo.org'' y si esto no funciona consulta la dirección del servidor IMAP en la documentación de tu proveedor de correo electrónico. Se recomienda encarecidamente usar una conexión cifrada a tu servidor IMAP. Para ello inserta el prefijo "imaps://" al principio de la dirección del servidor IMAP. Por ejemplo, `imaps://imap.servicio_de_ejemplo.org`.