`sftp` command line tool which is included on Linux, Mac OS X and other systems as part
of the OpenSSH suite, can be used to demonstrate connecting to your application container.
Connecting to your application container
Assuming that your container name is
`mycontainer`, and that you have saved your PEM encoded private
`~/keys/zendcloud-mycontainer.pem`, you will use the following command to connect to your
container using SFTP:
$ sftp -o IdentityFile=~/keys/zendcloud-mycontainer.pem \ email@example.com
`-o IdentityFile=...` option allows you to specify the path to your PEM encoded private key file.
On your first attempt to connect to your container using SFTP, you will be asked to approve
accepting the host's RSA fingerprint to the list of known hosts:
The authenticity of host 'mycontainer.my.phpcloud.com (10.20.30.40)' can't be established. RSA key fingerprint is 8f:e5:4c:82:9c:cb:7e:ce:9f:1c:ec:d7:45:04:34:46. Are you sure you want to continue connecting (yes/no)?
This is a regular procedure when connecting to remote servers using SSH based protocols - you should
`yes` to connect. Future connections to the same container should not prompt this
question. If all parameters were provided correctly, you will now be connected
to the server, and will be presented with the sftp prompt:
Working in the sftp Shell
The SFTP shell allows you to interactively manage files and directories on the remote server, over a secure
connection. Many of the commands resemble common UNIX shell commands, so those accustomed to using the
command line in Linux, Mac OS X or other similar systems will feel at home.
For example, to get a list of files in the current directory, use the
`ls -l` to get a more detailed listing of files.
The following set of commands demonstrate how you can change into your public document root directory,
and copy a file named 'hello.php' from your local machine to the remote machine:
sftp> ls -l drwxr-x--- 3 1005 1005 4096 Apr 13 10:47 mycontainer sftp> cd mycontainer/applications/container-root/public sftp> !ls -l total 1 -rw-r--r-- 1 shahar staff 30 Apr 28 11:05 hello.php sftp> put hello.php Uploading hello.php to /mycontainer/applications/container-root/hello.php hello.php 100% 30 0.0KB/s 00:00 sftp>
Here is a quick overview of these commands:
- ls -l
- Get a detailed listing of the files in the current directory
- cd mycontainer/applications/container-root/public
- Change into the mycontainer/applications/container-root/public directory (a directory relative to the current directory)
- !ls -l
- Run the
`ls -l`command in the local machine - this gives a listing of
files in the current local directory. Any command starting with '!' (an exclamation mark) will be
- put hello.php
- Copy the local file
`hello.php`from the current directory in the local machine to
the current directory in the remote machine
This shows some basic usage of the `sfp` interactive prompt. To learn more, you can type '?' or 'help'
at any time to get a list of commands with some usage information.