Getting started
Deploy your first app on DployHub
A step-by-step guide to deploying your first app on DployHub: pick a source, let us detect the build, choose resources and get a live HTTPS address.
Updated 3 min read
DployHub turns a repository or a Docker image into a running app with its own HTTPS address. You never pick or manage servers: you point us at your code, confirm a few settings and we build, run and keep it online. This guide walks through the whole flow from an empty account to a live app.
Before you start
- An account. Sign up takes a minute, then you land on the dashboard at /portal.
- Your code in a GitHub repository, any public Git URL, or a public Docker image.
- A project we can recognise at its root folder: a
Dockerfile, apackage.json(Node.js), arequirements.txt,pyproject.tomlorPipfile(Python), or anindex.html(static site).
Create the app
- 1
Open New app
In the dashboard go to Apps, then New app, or open /portal/apps/new directly.
- 2
Choose a source
Pick GitHub (connect your account, then choose a repository and branch), Public Git URL (paste an https:// or git@ URL and a branch) or Docker image (a public image name with a tag, such as
nginx:1.27-alpine). - 3
Choose how to build it
Leave "Figure it out for me" selected and we detect the framework, build command, start command and port. You can instead pick Use my Dockerfile, Node.js, Python or Static website.
- 4
Name your app
The name becomes a slug and your addresses: live at
https://<slug>.apps.dployhub.comand staging athttps://<slug>-staging.apps.dployhub.com. Renaming the app later keeps the same URLs. - 5
Pick resources
Choose vCPU, memory and storage for live. The monthly price updates as you change them, so you know the cost before you create anything. The default is 0.5 vCPU, 512 MB and 5 GB for ₹255 a month.
- 6
Create and deploy
We clone or pull your source, build it, start it and check that it answers. The first deploy of a new app goes live automatically.
Watch the build
Build logs stream live in the Deployments tab of your app, so you can see every install and compile step as it happens. Builds can run for up to 30 minutes. Once the image is ready we start the new container and wait up to 90 seconds for it to answer HTTP on the health check path. When it does, traffic switches to it.
What you get
- Two environments: staging and live, each with its own address, environment variables and custom domain.
- Automatic HTTPS on both addresses, and on any custom domain you add later.
- Logs, CPU and memory metrics and uptime for each environment.
- Zero-downtime releases: if a new version fails to start, the running version keeps serving.
Next steps
After the first release, new deploys go to staging first. Check the staging address, then press Go live to promote the exact same image to live, with no rebuild. From here you will probably want to add environment variables, connect a custom domain and, if you used GitHub, rely on auto-deploy on push.
If the build or release fails, the deploy is marked failed with the last 50 log lines and a plain-language reason. Start with Build failed, and if you are still stuck, raise a ticket from Help & tickets with the app and deployment attached.
Frequently asked questions
Do I need to choose a server or cloud region?
No. DployHub runs your app and decides where it runs. You only choose the resources your app needs.
Does the first deploy go to staging or live?
The first deploy of a new app goes live automatically. Later deploys go to staging first and you promote them with Go live.
Can I change the build settings after creating the app?
Yes. Every detected value, including build command, start command, port and health check path, can be changed in the app Settings.
Related articles
- Connect GitHub and deploy a repositoryConnect your GitHub account to DployHub to deploy public or private repositories, pick a branch and get automatic deploys to staging on every push.
- Build settings: build, start, root folder and moreEvery DployHub build setting explained: build type, build and start commands, port, root folder, Dockerfile path and health check path, with examples.
- Staging and live environments: test, then go liveEvery DployHub app has a free staging environment and a live one. Learn how deploys flow through staging and how Go live promotes the same image.
- Port and health checks for zero-downtime deploysHow DployHub uses your port and health check path to release new versions with zero downtime, what the failure messages mean and how to fix them.