mirror of
https://github.com/freedombox/FreedomBox.git
synced 2026-01-21 07:55:00 +00:00
doc: Fetch latest manual
Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org>
This commit is contained in:
parent
e29df8fe4d
commit
7764b0a2c7
@ -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`.
|
||||
|
||||
|
||||
@ -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 |
BIN
doc/manual/en/images/xmpp-clients_en_V02.png
Normal file
BIN
doc/manual/en/images/xmpp-clients_en_V02.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 67 KiB |
@ -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`.
|
||||
|
||||
|
||||
@ -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
|
||||
|
||||
|
||||
@ -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 |
BIN
doc/manual/es/images/xmpp-clients_en_V02.png
Normal file
BIN
doc/manual/es/images/xmpp-clients_en_V02.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 67 KiB |
Loading…
x
Reference in New Issue
Block a user