diff --git a/filezilla.md b/filezilla.md index a6f54fea..9328ffa9 100644 --- a/filezilla.md +++ b/filezilla.md @@ -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)
You can now use your new bookmark to connect to the server
-### 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 - -
- 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/` -
- -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)
- Be sure to download both files + Be sure to download both the `.tar.gz` and `.json` files.
![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)) -* +* [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. * * +### Windows + +* [WinSCP](https://winscp.net/) is also a nice candidate for Windows + ### MacOS -Feel free to complete this part \ No newline at end of file +Feel free to complete this part