doc: Fetch latest manual

Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org>
This commit is contained in:
Sunil Mohan Adapa 2025-03-14 16:23:39 -07:00
parent e29df8fe4d
commit 7764b0a2c7
No known key found for this signature in database
GPG Key ID: 43EA1CFF0AA7C5F2
9 changed files with 32 additions and 26 deletions

View File

@ -76,7 +76,8 @@ Usually any Unix system, including Linux in all (most) of its flavours and Mac,
Examples:
Connect to !FreedomBox via SSH:
1. (replacing `username` with a valid !FreedomBox user name and `freedombox.local` with your !FreedomBox's domain name or IP): {{{
1. (replacing `username` with a valid !FreedomBox user name and `freedombox.local` with your !FreedomBox's domain name or IP):
{{{
$ ssh username@freedombox.local
}}}
1. If your data is ok and your !FreedomBox reachable, the first time you'll be asked to confirm its signature.
@ -85,36 +86,41 @@ $ ssh username@freedombox.local
1. The prompt changes to `username@freedombox:~$`.
Once connected create your website folder with:
{{{
{{{
username@freedombox:~$ mkdir ~/public_html
}}}
...or one for another user:
1. use the `sudo` prefix like {{{
1. use the `sudo` prefix like
{{{
username@freedombox:~$ sudo mkdir /home/<the_other_user>/public_html
}}}, and introduce your password.
1. When you create a folder, by default it belongs to you no matter where it is created. Thus you'll then need to set its ownership to the other user: {{{
username@freedombox:~$ sudo chown <the_other_user>:<the_other_user> /home/<the_other_user>/public_htm
}}}
1. Better check it before you disconnect that `public_html' is listed among the contents of the other user's home folder.
and introduce your password.
1. When you create a folder, by default it belongs to you no matter where it is created. Thus you'll then need to set its ownership to the other user:
{{{
username@freedombox:~$ sudo chown <the_other_user>:<the_other_user> /home/<the_other_user>/public_html
}}}
1. Better check it before you disconnect that `public_html` is listed among the contents of the other user's home folder.
{{{
username@freedombox:~$ ls -l /home/<the_other_user>
...
drwxr-xr-x 2 <the_other_user> <the_other_user> 4096 jan 29 17:39 public_html
...
}}}. The name of the other user must appear '''twice''' in the `public_html` line and its permissions should be '''`drwxr-xr-x`'''.
}}}
The name of the other user must appear '''twice''' in the `public_html` line and its permissions should be '''`drwxr-xr-x`'''.
Then any user can upload their files to their respective folders with any of the graphical clients. Ask them to check it.
It is a good security practice to exit instead of to just wait for the connection to time out:
{{{
{{{
username@freedombox:~$ exit
}}}
If then you want to also upload the web content through the command line you can
{{{
$ scp path/to/files username@freedombox.local:public_html/
}}}. It will ask your password in !FreedomBox. You should then be able to navigate your browser to the corresponding url and see the files.
}}}
It will ask your password in !FreedomBox. You should then be able to navigate your browser to the corresponding url and see the files.
Learn more about ssh, scp and sftp with `$ man ssh`, `$ man scp` and `$ man sftp`.

View File

@ -59,7 +59,7 @@ If your !FreedomBox is behind a router, you will need to set up port forwarding
* !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_V02.png|XMPP clients}}
==== FreedomBox webclient ====

Binary file not shown.

Before

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 67 KiB

View File

@ -70,7 +70,8 @@ Normalmente cualquier sistema Unix, incluyendo a Linux en (casi) todos sus sabor
Ejemplos:
Conectar con !FreedomBox mediante SSH:
1. (reemplazando `usuario` por un nombre de usuario válido en !FreedomBox y `freedombox.local` por el nombre de dominio o la IP de tu !FreedomBox): {{{
1. (reemplazando `usuario` por un nombre de usuario válido en !FreedomBox y `freedombox.local` por el nombre de dominio o la IP de tu !FreedomBox):
{{{
$ ssh usuario@freedombox.local
}}}
1. Si tus datos son correctos y tu !FreedomBox está accesible la primera vez se te pedirá confirmar su identificación.
@ -79,15 +80,18 @@ $ ssh usuario@freedombox.local
1. El prompt cambia a `usuario@freedombox:~$`.
Una vez conectado crea la carpeta de tu sitio web mediante:
{{{
{{{
usuario@freedombox:~$ mkdir ~/public_html
}}}
...o crea la del sitio de otro usuario:
1. Usa el prefijo `sudo` así: {{{
1. Usa el prefijo `sudo` así:
{{{
usuario@freedombox:~$ sudo mkdir /home/<el_otro_usuario>/public_html
}}}, e introduce tu contraseña.
1. Al crear una carpeta, por defecto te pertenece a tí la crees donde la crées. Por tanto, necesitarás poner como dueño al otro usuario: {{{
}}}
e introduce tu contraseña.
1. Al crear una carpeta, por defecto te pertenece a tí la crees donde la crées. Por tanto, necesitarás poner como dueño al otro usuario:
{{{
usuario@freedombox:~$ sudo chown <el_otro_usuario>:<el_otro_usuario> /home/<el_otro_usuario>/public_htm
}}}
1. Antes de desconectar mejor verificas que `public_html' se muestra entre los contenidos de la carpeta `home` del otro usuario.
@ -96,19 +100,21 @@ usuario@freedombox:~$ ls -l /home/<el_otro_usuario>
...
drwxr-xr-x 2 <el_otro_usuario> <el_otro_usuario> 4096 jan 29 17:39 public_html
...
}}}. El nombre del otro usuario tiene que aparecer '''por duplicado''' en la línea de `public_html` y sus permisos deben ser '''`drwxr-xr-x`'''.
}}}
El nombre del otro usuario tiene que aparecer '''por duplicado''' en la línea de `public_html` y sus permisos deben ser '''`drwxr-xr-x`'''.
Ahora el otro usuario puede subir sus archivos con cualquiera de los clientes gráficos. Pídeles que lo comprueben.
Es una buena práctica de seguridad salir en vez de esperar simplemente a que la conexión caduque:
{{{
{{{
usuario@freedombox:~$ exit
}}}
Si quieres emplear la linea de órdenes también para subir contenido puedes
{{{
$ scp ruta/a/los/archivos usuario@freedombox.local:public_html/
}}}. Te pedirá tu contraseña en !FreedomBox. A continuación deberías poder ir con tu navegador a la URL correspondiente y ver tus archivos.
}}}
Te pedirá tu contraseña en !FreedomBox. A continuación deberías poder ir con tu navegador a la URL correspondiente y ver tus archivos.
Más acerca de ssh, scp y sftp con `$ man ssh`, `$ man scp` y `$ man sftp`.

View File

@ -69,15 +69,9 @@ 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:
* bind9
* firewalld
* janus
* minetest-server
* minidlna
* mumble-server
* radicale
* roundcube-core
* tt-rss
## END_INCLUDE

View File

@ -57,7 +57,7 @@ Si tu !FreedomBox está detrás de un router tendrás que configurar en él la r
* !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_V02.png|clientes XMPP}}
==== Cliente Web de FreedomBox ====

Binary file not shown.

Before

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 67 KiB