Quickstart
This guide takes you from a fresh install to an app with a database, reachable at your own domain. You need a running Harblet, see Installation.
Create a project
Click Projects in the sidebar, then New project. Name it after your app, for example My App, and click Create project.
Add a database
In the project, click New service → Database. Keep PostgreSQL and the defaults, and click Create database.
Once it shows Deployed, open it. Its Overview tab shows the connection details. Copy the Connection URL.
Deploy your app
Back in the project, click New service → Git repository.
- Name: for example
Web. - Repository: the
https://URL of a public repository. For private repositories on GitHub or GitLab, an admin connects them first under Settings → Git, see Git repositories. - Branch: the branch to deploy,
mainby default. - Port: the port your app listens on, for example
3000. Harblet passes it to your app asPORT.
Click Create service. Harblet starts building right away. Open the service and watch the build on its Deployments tab.
Web as the name, nginx:latest as the image and 80 as the port.Give it the database
Open the app's Environment variables tab. Click Add variable, enter DATABASE_URL as the key and paste the connection URL as the value. Click Save, then Deploy.
Add your domain
- Create a DNS A record for your domain, for example
app.example.com, with the IP address of your server. - Go to SSL Certificates in the sidebar and click Upload certificate. Paste the certificate with its intermediate certificates, and its private key. See Certificates.
- Open the app's Domains tab, enter
app.example.comand click Add domain.
Open https://app.example.com. Your app answers there.