SSH is a protocol that allows you to access your server via a command line terminal. SSH keys are used to authenticate with your server over the SSH protocol. If you are new to SSH keys, we recommend checking out the GitHub documentation of generating SSH keys to get started.
After adding your SSH key to your server, you may SSH into the server without a password:
ssh forge@YOUR_SERVERS_PUBLIC_IP_ADDRESS
Before you provision a server for the first time, you should add your SSH keys to your account. You can do this from the your accounts SSH Keys page in the Forge dashboard.
As part of the provisioning process, Forge will add all your active SSH keys to the forge
account. This will allow you to SSH into the server as the forge
user.
If any of your sites are using User Isolation, you will be asked to select the user you want to add the key to. You will then be able to SSH into the server as that user.
If you already have servers provisioned and want to add a new SSH key to several servers at once, then first add your key to your account via the SSH Keys page. Once it is listed in the "Active Keys", you may use the "Add To Servers" action and select which servers you would like the key added to.
You can also add SSH keys directly to a server without adding them to your account.
During the provisioning process, Forge will generate its own keypair so that it may access the server. It will add the public key from this keypair to the authorized_keys
file of both the root
and forge
users.
During the provisioning process, Forge will generate a public key for the forge
user. This is used by Git to clone the projects to your server. The key will be added to the source control provider. This key is located at /home/forge/.ssh/id_rsa.pub
.