This article assume that you've created your application (website) on your home computer. The steps below then guide you through how to put this application code under Git version control and push to your DreamHost server.
Creating an SSH key pair
- Download and install Git for Windows:
- This example uses 2.14.1.
Select all default options during installation. For example, you should leave the radio button selected for Use Git from Git Bash only and all options for OpenSSL.
- You must create SSH keys to interact with your DreamHost server. From the start menu, locate the program you just installed. You're looking for Git Gui.
- Click the Help menu and select Show SSH Key.
- From the pop-up, click Generate Key on the top right.
- You are asked for a passphrase. Leave the input field empty and click OK twice.
- Your public key is displayed. Click Copy To Clipboard.
- Open your start menu and open the program Notepad. Once opened, paste this public key.
- Save the file and name it something like dreamhost-git-key.pub. Make sure to save it in your Documents folder.
Uploading the public key to your DreamHost server
- Navigate to your Documents folder.
- Right click and select Git Bash Here. This opens a terminal. Since you opened Git Bash inside the Documents folder, the terminal prompt should look like this:
user@computer MINGw64 ~/Documents $
- In the terminal, run the following command to ensure the dreamhost-git-key.pub you saved above is in this Documents directory.
[server]$ ls -la | grep dreamhost dreamhost-git-key.pub
The terminal outputs the name of the public key file you saved.
To run the following commands, you need the name of your DreamHost server and the user/pass your website is under. View the following articles to locate this information:
Additionally, the DreamHost website username you're running the command with must be configured as a Shell user. View the following article on instructions on how to configure this:
- Run the following command to upload your public key to your DreamHost server (make sure to use your website's user and server name):
[local ~]$ cat ~/Documents/dreamhost-git-key.pub | ssh email@example.com "mkdir ~/.ssh; cat >> ~/.ssh/authorized_keys"
You may receive the following error when running this command:
mkdir: cannot create directory `/home/username/.ssh': File exists
This simply means the /.ssh directory already exists on the web server. If you see this, remove the portion of the command that creates the directory and run again. For example:
[local ~]$ cat ~/Documents/dreamhost-git-key.pub | ssh firstname.lastname@example.org "cat >> ~/.ssh/authorized_keys"
- Log into your DreamHost server via SSH:
[local ~]$ ssh email@example.com
- Confirm your key has been added to the DreamHost server by running the following (this should output your key):
[local ~]$ cat ~/.ssh/authorized_keys
- Create a new directory for your new remote repository on your DreamHost server. If this code is meant to update your existing website, you could name it the same as your website ending in .git. For example, something like example.com.git.
Since this is a remote repository and not a working repository, the directory name you create must end with .git. You can then checkout this repository in the future to work on it.
[server]$ cd ~ [server]$ mkdir example.com.git [server]$ cd ~/example.com.git [server]$ git init --bare [server]$ git symbolic-ref HEAD refs/heads/main
- Run ls -la to confirm the files and directories have been created.
[server]$ ls -la HEAD /branches config description /hooks /info /objects /refs
- Confirm the HEAD file is set to use main by running the following command.
[server]$ cat HEAD ref: refs/heads/main
- You should see main being used.
Creating a Git repository on your computer
- Navigate to your project folder.
- Right click and then select Git Bash Here.
- This opens up a terminal that's already running Git.
- Run the following to create your user and email to be used with Git. This also sets the primary branch to main instead of the master:
[local ~]$ git config --global user.name "John Doe" [local ~]$ git config --global user.email firstname.lastname@example.org [local ~]$ git config --global init.defaultBranch main
The last line ensures newly created repositories use the name main as the primary branch. View the following article for further details:
- This creates a .gitconfig file under your username. You can view it at: C:\Users\yourusername\.gitconfig
- Run the following in your project directory to initialize the repository and create your first commit:
[local ~]$ git init [local ~]$ git add . [local ~]$ git commit -m "First Commit"
- When you initialize the repository, a directory titled .git is created.
By default, you cannot see this in Windows. If you'd like to view hidden files (files that start with a period), click View in the top menu. To the right, check the box for hidden files. You do not need to view this .git folder to proceed with these steps. This is just a way for you to see your commands have created the local repository.
- Add the remote repository. Make sure to use your Shell user and server name.
The word dreamhost is just an alias. It can be named anything you want. But this alias name will be used when you push your content to github.com.
[local ~]$ git remote add dreamhost ssh://email@example.com/~/example.com.git [local ~]$ git push -u dreamhost main
- Check your DreamHost server to confirm the repository was correctly pushed by following the instructions in the next section.
Confirming your repository was correctly pushed to your DreamHost server
- Log into your DreamHost server via SSH.
When you run git status in the /example.com.git directory, you'll receive the following error because this directory is not a 'working tree':
[server]$ git status fatal: This operation must be run in a work tree
- Clone the repo to a new location by running the following in your user's directory:
[server]$ mkdir ~/clonedproject.git [server]$ cd ~/clonedproject.git [server]$ git clone ~/example.com.git ~/clonedproject.git [server]$ ls -la
- This directory contains all the files you pushed from your local machine.
How can I use Git for web development?
View the following article for instructions on how to push changes on your local computer to your live website.