(You must already be logged in to Gitlab or you’ll hit a 404)
Connecting to your server
Before you start this section
1. Install FileZilla on your computer; it is freely available from its project website for Windows, Mac OS X, and GNU/Linux.
In this chapter you’ll learn how to connect to your server ready to transfer files using the FileZilla program. It has been assumed that you have a working copy of this program installed on your desktop computer.
A server installed with Symbiosis will be running SSH, and will have had the
admin user account created. This allows you to connect via SFTP to administer the machine.
admin account should be used when administering a Symbiosis system to ensure that files and directories have the correct permissions.
Usage of SFTP is mandated for administrating the machine, such that all data are passed encrypted over the network.
Connecting using FileZilla
Throughout the documentation the example server name
example.default.bytemark.uk0.bigv.io should be substituted for your own server
Start FileZilla and enter the details in the text fields below the program’s toolbar. The name of your server goes in the
Complete the connection details by filling in the
cwith the password for the
adminuser (by default, this is the same as the root password provided during the setup of your VM), and the standard SSH port number,
Quickconnectbutton a to the right of the text fields; the first time you do this you’ll get a warning message that is safe to ignore, so check its
band click the
In the text area immediately below the “Quickconnect bar” you’ll see messages scroll by as the connection to the server is made.
You won’t need to enter those details each time you connect. Click the small button to the right of the Quickconnect button to reveal the
sftp://email@example.com a history item. In future simply select that link.
The following figure shows *FileZilla*’s layout after successfully logging in. The display is divided into four main sections, the top left pane shows a directory tree, with the directories on your local computer, labelled
a. Beneath that is a listing showing the contents of the currently selected local directory, labelled
b. Then the top right pane shows the directory tree of the remote machine. When logging in as
admin this will show
c). Finally beneath that is the contents of that directory. Initially this will only contain one directory named after the machine. In this case
example.default.bytemark.uk0.bigv.io/ is shown (
Common FileZilla recipes
This section demonstrates how to carry out some common tasks with the FileZilla client
Navigating local and remote filesystems
To open the
/srv/directory on the server, click the
Notice that the folders that appear in the tree display are already displayed in the Filename window. You can use the scrollbars
bto adjust the view; as in any desktop window you can also use the maximise window control
cto expand the FileZilla display to full screen or just drag its corners in the usual way.
When you click on the
example.default.bytemark.uk0.bigv.iolabel (not the directory icon), the
+control appears. The contents of the directory are already displayed in the
+control to see those contents as part of a tree view and notice that you now have a
-control, which could be used to close this detail of the file system structure.
Those operations were all carried out on the right side of the screen where the Remote site:, in this case the server
example.default.bytemark.uk0.bigv.io, is represented. Comparable operations can be carried out on the left side of the screen, where the Local site:. represents the file system on the desktop machine.
Creating a remote directory
In this walkthrough, a mailbox will created for a user alice. That
is done by creating a directory under the
/srv/my-brilliant-site.com/mailboxes/ directory. (The configuration of email is described fully in
Highlight the parent directory by pointing at the
mailboxeslabel (not the icon) and left-clicking.
Right click to bring up the menu and select
Create directorydialog opens; the default path
/srv/my-brilliant-site.com/mailboxes/. is as we want it, but not the default name
Edit that, replacing
alice/, then click the
/srv/my-brilliant-site.com/mailboxes/alice/has been created.
Deleting files and directories
passwordfile on the local machine is no longer needed; select and right click then choose the
Confirm that you do want to delete the file by pressing the
Yesbutton in the
passwordfile has been deleted. In the same way files and also directories can be deleted from the server, the only difference being that the
Confirmation neededdialog that comes up is less detailed than the local Delete file dialog. Below is what would be seen if user alice was to be removed; the
alice/directory and the
Deleteoption have been selected.
Yesbutton in the
Confirmation neededdialog was selected and the
alice/directory has been removed.