Forking the Consul Repo

Community members wishing to contribute code to Consul must fork the Consul project (your-github-username/consul). Branches pushed to that fork can then be submitted as pull requests to the upstream project (hashicorp/consul).

To locally clone the repo so that you can pull the latest from the upstream project (hashicorp/consul) and push changes to your own fork (your-github-username/consul):

1. Create the forked repository (your-github-username/consul)
2. Clone the hashicorp/consul repository and cd into the folder
3. Make hashicorp/consul the upstream remote rather than origin: git remote rename origin upstream.
4. Add your fork as the origin remote. For example: git remote add origin https://github.com/myusername/consul
5. Checkout a feature branch: git checkout -t -b new-feature
6. Make changes
7. Push changes to the fork when ready to submit a PR: git push -u origin new-feature