GitHub deployment
Deploy an app from GitHub with Railpack
Use the hosted build path when you want push-to-deploy without maintaining your own image pipeline.
01
Prepare the repository
The repository must contain the application and the files its normal production build needs. Private repositories require access through the Host Little GitHub App.
Confirm that the application listens on the PORT environment variable and binds to 0.0.0.0 so the runtime can reach it.
02
Create the project
- 1Sign in with GitHub and add a card for the monthly plan.
- 2Choose the repository, production branch, and one of the available launch regions.
- 3Review the Database Hosting preview; public PostgreSQL provisioning is not enabled yet.
- 4Review the monthly usage credit and continue through Stripe Checkout.
03
Build and verify
Host Little uses Railpack to detect the application and build an OCI image away from the runtime. The runtime pulls the completed image.
A new container must pass its HTTP health check before it receives traffic. Review deployment history and redacted logs if the build, startup, or check fails.
04
Configure the service
- 1Add required environment variables from the project Environment page.
- 2Open the hostlittle.app address and test a customer path after the deployment is healthy.
- 3Add a custom domain and follow the DNS records shown in the portal when the app is ready.