using_custom_domains_with_github.md

published	true
permalink	/using_custom_domains_with_github/
layout	default
filename	using_custom_domains_with_github.md

Background

Agencies can easily stand up microsites and tools hosted entirely in GitHub. There are good reasons to still provide those pages with the imprimatur of a .gov address. Below are instructions for each of several scenarios that an agency might want to use.

Scenario 1 - Custom Domain (example.gov)

Scenario 2 - Subdomain of an Existing Website (example.agency.gov)

Scenario 3 - Top-Level Folder of an Existing Website (www.agency.gov/example)