YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

Misc improvements for english filezilla page

Browse source
This commit is contained in:
Alexandre Aubin 2019-01-24 01:31:56 +01:00
parent a425e06d06
commit a9de6516a7
1 changed files with 34 additions and 53 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

87
filezilla.md
View file

@ -1,78 +1,59 @@
# Exchange files with your server graphically
# Exchange files with your server using a graphical interface
This page will explain how to exchange files with your server graphically so you don't necessary have to use [SCP cryptic commands](/backup) or Nextcloud.
This page explains how to exchange files (backup archives, music, pictures,
movies, ...) with your server using a graphic interface. This is an alternative
to using `scp` which can be deemed technical and cryptic, or using an app like
Nextcloud.
You could want to download your backups or send some music, pictures, movies, ...
[Filezila](https://filezilla-project.org/) can be used for this. It is a free
software and is available for Windows, Linux and macOS.
[`Filezila`](https://filezilla-project.org/) will be mainly used as it is a free software and is available for Windows, Linux and macOS.
## Download and install FileZilla
## Requirements
Get the client from the [download page](https://filezilla-project.org/download.php?type=client). It should automatically detect the version needed for your computer. Otherwise, follow the instructions to [install the client](https://wiki.filezilla-project.org/Client_Installation)
You will need to know the `IP` or `domain name` of your server for being able to connect to it.
See page [SSH](/ssh) if you don't know this information.
Install the program and run *Filezilla*.
## Filezilla
## Configuration
### Download and install
1. Click the *Site Manager* icon in the upper left to begin.
Get the client from the [download page](https://filezilla-project.org/download.php?type=client). It should autodetect the version needed for your computer. If it fails, follow the instructions to [install the client](https://wiki.filezilla-project.org/Client_Installation)
![Main screen of Filezilla](images/filezilla_1.png)
Install the program and run `Filezila`.
2. Click **New Site** and give a name the server you will be using : *Familly* here. Fill the settings as on the screenshot (replace the server adress with your own), and click on **Connect**.
### Configuration
![Site manager screen](images/filezilla_2.png)
1. Click the *Site Manager* icon in the upper left to begin setting up a connection bookmark for future use.
3. You will get a warning as you connect for the first time to the server. *You can ignore it safely the first time you get it.*
![Main screen of Filezilla](images/filezilla_1.png)
![warning about the unknown fingerprint of the server](images/filezilla_3.png)
2. Click **New Site** and give a name the server you will be using : *Familly* here. Fill the settings as on the screenshot except for your server which should be yours
4. Filezilla is now asking the `admin` password for connecting to your server.
Once finish, click on **Connect**
![credential screen asking for the password](images/filezilla_4.png)
![Site manager screen](images/filezilla_2.png)
5. Once bookmarked, your server will be backup up and you will get this screen.
3. You will get a warning as you connect for the first time to the server. *You can ignore it safely the first time you get it*
![warning about the unknown fingerprint of the server](images/filezilla_3.png)
4. Filezilla is now asking the `admin` password for connecting to your server
![credential screen asking for the password](images/filezilla_4.png)
5. Once bookmarked, your server will be backup up and you will get this screen
![View of the "site manager" with the newly server added](images/filezilla_5.png)
![View of the "site manager" with the newly server added](images/filezilla_5.png)
<div class="alert alert-success">
<span class="glyphicon glyphicon-chevron-right"></span> You can now use your new bookmark to connect to the server
</div>
### Usage
## Usage
1. Connect to the Site created previously. *Your passwork might be asked again*
On the left, you have your computer and on the right, the remote Yunohost server. You can navigate between folders as if you were on your computer and do drag and drops.
The left panel corresponds to your computer. The right panel corresponds to your remote Yunohost server. You can browse folders and drag-and-drop files between the two panels.
![view while connected to a remote server](images/filezilla_6.png)
![view while connected to a remote server](images/filezilla_6.png)
2. In the right panel, navigate to `/home/yunohost.backup/archives/` where the backups are stored.
2. In the right panel, you can browse to `/home/yunohost.backup/archives/` to find [backup archives](/backup).
![path where backups are located on Yunohost](images/filezilla_7.png)
#### Workaround to retrieve the backups
<div class="alert alert-danger">
<span class="glyphicon glyphicon-exclamation-sign"></span> Since Yunohost version 3.3 and the choice to connect as the `admin` user, there is a [limitation](https://github.com/YunoHost/issues/issues/1266) that prevents straight access to the backups folder `/home/yunohost.backup/archives/`
</div>
Until the issue is solved, you will need to follow [a workaround](/backup_workaround) to manage the backup files.
#### Back to Filezilla
You can now see backups previously copied and download them to your computer.
![path where backups are located on Yunohost](images/filezilla_7.png)
<div class="alert alert-warning">
<span class="glyphicon glyphicon-cloud-download"></span> Be sure to download both files
<span class="glyphicon glyphicon-cloud-download"></span> Be sure to download both the `.tar.gz` and `.json` files.
</div>
![Copy backups from Yunohost to local computer](images/filezilla_8.png)
@ -82,23 +63,23 @@ You can now see backups previously copied and download them to your computer.
Sources
* [Official documentation](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(en))
* <https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/>
* [General tutorial about using FileZilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/)
## Alternatives to Filezilla
### Windows
* [`WinSCP`](https://winscp.net/) is also a nice candidate for Windows
### Linux
From any recent Linux, you should be able to use the `file manager` to reach your server.
Nautilus from Gnome3 can access out of the box.
Nautilus from Gnome3 has features similar to FileZilla, out of the box.
* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
### Windows
* [WinSCP](https://winscp.net/) is also a nice candidate for Windows
### MacOS
Feel free to complete this part
Feel free to complete this part