SuperHosting Kirby Git SSH setup instructions

superhosting-ssh.md

1. Open a terminal from cPanel

2. Use ssh-keygen to generate a key (with no passphrase)

   Note: You can't use SuperHosting's GUI SSH key manager because it demands a passphrase, and that's not an option since kirby-git can't fill it in.

3. Run cat ~/.ssh/id_rsa.pub to print the public key and copy it

4. Go to GitHub and paste the public key (in the Deploy Keys settings panel)

5. Test with ssh -T -p 443 git@ssh.github.com

   Expected output:

   Hi {{ owner }}/{{ repo }}! You've successfully authenticated, but GitHub does not provide shell access.

6. Create a ~/.ssh/config file that looks like this:

   Host github.com
   	HostName ssh.github.com
   	User git
   	Port 443
   

   This allows you to ssh to github.com without having to specify any settings (e.g. port).

7. Verify that your config file works by running ssh -T github.com. You should get the same output:

   Hi {{ owner }}/{{ repo }}! You've successfully authenticated, but GitHub does not provide shell access.

8. Run rm -rf ~/public_html to clear the folder where the site will be (SH adds some boilerplate files there)

9. Run git clone git@github.com:{{ owner }}/{{ repo }}.git to copy the repo

10. Run git checkout -b live to switch to branch live

11. If the plugin shows a wrong version of Git, there are likely multiple versions installed on the system. Use the oblik.git.bin option to specify the latest one to use

12. Log in the panel and test it out