====== SSH (Secure Shell Protocol) (definition) ======

If you have chosen to [[:en/hosting/gandi-expert/create-server|create your VPS in Expert mode]], then the only way you will be able to access your Gandi server at the start is by using secure shell protocol (SSH).

Servers [[:en/hosting/create-server/gandi-ai|created in Gandi AI (auto-install) mode]] can be accessed via SSH as well as through the web interface.

===== Description =====
SSH is a program that will let you log into any remote machine such as a VPS and execute commands on that machine from a distance in a way that is secure and encrypted. 

===== Connecting =====

Enter the ''ssh'' command and the name of your Gandi server username: 

   ssh yourusername@123.123.123.123

You will then see:

   The authenticity of host '123.123.123.123 (123.123.123.123)' can't be established.
   RSA key fingerprint is XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX.
   
   Are you sure you want to continue connecting (yes/no)? yes

Type ''yes'' and hit return:

   Warning: Permanently added '123.123.123.123' (RSA) to the list of known hosts.
   
   yourname@123.123.123.123's password: 
 
...and enter your password. If the password is correct, then you will have successfully connected to your Gandi server. 

You will then be able to work securely on your Gandi server from your home or office computer.

===== Open source SSH clients =====
==== Linux ====
  * [[http://www.openssh.com/features.html|OpenSSH]] 
==== Mac ====
In Mac OS X, you simply need to open a terminal and type the commands. 
OpenSSH comes pre-installed and ready-to-use. 
  * [[http://www.openssh.com/features.html|OpenSSH]]

==== Windows ====
  * [[http://sshwindows.sourceforge.net/|OpenSSH for Windows]]
  * [[http://www.chiark.greenend.org.uk/~sgtatham/putty/|PuTTY: A Free Telnet/SSH Client]]

===== See also =====
  * [[:en/hosting/gandi-expert/ssh-console]]
  * [[:en/hosting/using-linux/how_to_connect_ai]]