NC

Naijacloud

Docs

DashboardStart free

Quickstart

This walks through one deploy end to end. You connect a repository, pick a region and size, and get a managed HTTPS URL that redeploys on every push.

5 min read

You need a Naijacloud account and a Git repository containing a web application. Nothing else. No Dockerfile, no CI configuration.

1. Create a project

From Projects, choose New project. A project is a container for the services that make up one application, across all of its environments.

Once created, the project opens on its prod environment with no services yet.

A project page showing its dev, uat and prod environment tabs above a list of services
Environment tabs run across the top. Each environment holds its own copy of every service.

2. Add a web service

Choose New service, then Web service. This opens one form covering everything the service needs to run.

The deploy a web service form, with source, build, environment variables, region and instance type sections

Working down the form:

  1. Source. Connect your GitHub account and pick the repository and branch. You can also deploy a public repository by URL, or an image you already have. See Connecting a source.
  2. Build. We detect most stacks and fill in the build and start commands. Override them if your project needs something else. See Builds & start commands.
  3. Environment variables. Anything your app reads at runtime. See Environment variables.
  4. Region. Where the service runs. Pick the region closest to your users.
  5. Instance type. How much CPU and memory the service gets. Start small. You can change it later without redeploying from scratch.

The summary panel on the right shows what you are about to create, including the estimated monthly cost, before anything is provisioned.

3. Deploy

Choose Create web service. We clone the repository, build an image, start the container, and wait for it to respond before sending traffic to it.

You can watch the build as it happens:

Live build and runtime logs streaming for a service
Build and runtime logs stream live. Failed builds highlight the line that broke.

When the build finishes and the health check passes, the service goes Live on its own HTTPS URL.

A live service overview showing its URL, region, instance type, request rate and recent deploys
i

Deploys are zero-downtime. Traffic only moves to a new release once it is healthy. If a build or health check fails, the previous version keeps serving.

4. Push to deploy

Every push to the connected branch triggers a new deploy automatically. There is nothing else to wire up.

Next steps