Deploy from GitHub
Connect a repository once; every push to your branch deploys a new version, with no downtime.
Connect GitHub
When you create a project, Where's your code? asks you to connect GitHub. You approve DockHosting on GitHub and choose which repositories it may read: all of them, or only some. Private repositories work.
You can change this later in Settings → GitHub in the dashboard.
Create the project
Pick the repository and branch
Choose the repository, then the branch to deploy (usually main). If your app lives in a subfolder of a monorepo, pick the folder: we list the ones that contain an app.
Review what we detected
We read the repository and show the stack, the install, build and start commands, the port, and the variables your code reads. Change anything that's wrong; most apps need nothing changed. See How a deploy works for what we detect.
Add variables and a database
Fill in the variables your app needs. If it uses a database, create one in the same screen: it's linked and your app receives DATABASE_URL and the usual DB_* variables. See Variables.
Deploy
Pick the address and deploy. You can follow every step live.
Deploys on push
After the first deploy, every push to the branch starts a new deploy. Your app keeps serving the previous version until the new one is ready, then traffic switches over.
To deploy only when you choose, turn off Auto-deploy in the project's Settings, then use Redeploy on the project page.
“Reconnect GitHub”
If GitHub stops accepting DockHosting's access (you revoked it, or your token expired), deploys stop with a Reconnect GitHub message and a banner in the dashboard. Reconnect in Settings → GitHub, then deploy again. See GitHub access.
Change the folder or the commands
Open the project's Settings: App folder, Install command, Build command, Start command and Port apply at the next deploy. To deploy another branch, create a project for it.