Skip to main content

Deploy your first service

A complete deploy from a fresh install, using the denia push client flow — no local Docker, no git remote, no pre-deploy commit. Assumes you have run sudo denia setup and created an admin account via /v1/bootstrap (see Installation).

1. Authenticate the client​

On your dev machine:

denia auth --url https://your-node.example.com
# prompts for username + password; mints and stores a long-lived API token (0600)

2. Scaffold a .denia manifest​

From your project root:

denia init

This writes a .denia template. Edit the values — at minimum the project, service name, and listen port:

project = "default"
service = "api"

# dockerfile = "Dockerfile"
# context    = "."

[create]
port = 8080
# health_path = "/healthz"

3. Create the service​

denia create

denia create reads .denia and creates the service with an upload source — its image is built from the working tree you push, so there is no Git repo or image reference to configure. (You can also create the service in the web console: pick a project, choose Upload as the source, set the listen port and health-check path, and save.)

4. Push​

From the project directory:

denia push

Denia packs your working tree (honoring .gitignore/.dockerignore), uploads it, builds the Dockerfile with BuildKit on the node, runs the health-gated deploy, and tails the build + deploy logs until the service reports Healthy.

Shortcut: denia push --create does steps 3 and 4 in one go (it still needs a [create] block in .denia).

5. Expose it​

Attach a hostname and enable TLS — see Custom domains & TLS. Once the domain is verified and a cert is issued, the service is live on :443.

6. Inspect it​

From the console, or over the API:

TOKEN=...   # an API token, e.g. from `denia auth`
SID=...     # the service id

# recent logs
curl -fsS -H "Authorization: Bearer $TOKEN" \
  https://your-node.example.com/v1/services/$SID/logs

# live runtime metrics (cgroup v2 + procfs)
curl -fsS -H "Authorization: Bearer $TOKEN" \
  https://your-node.example.com/v1/services/$SID/metrics

For an interactive shell inside a running replica, use denia console <service>.