dina-cli

Dina CLI

Before you start

Check if the CLI is installed:

which dina

If dina is not found, install it using one of these methods (pick the best one for the user's system):

macOS/Linux with Homebrew:

brew install dinacomputer/tap/dina

macOS/Linux without Homebrew:

curl -sSL https://raw.githubusercontent.com/dinacomputer/cli/main/install.sh | sh

Custom install directory (no sudo):

INSTALL_DIR=~/.local/bin curl -sSL https://raw.githubusercontent.com/dinacomputer/cli/main/install.sh | sh

Go (if the user has Go installed):

go install github.com/dinacomputer/cli/cmd/dina@latest

After installation, verify it works and check for updates:

dina version
dina check-update
dina update  # if an update is available

Quick start

# authenticate
dina auth login

# create and deploy an app
dina apps create my-app
dina deploy -a my-app

# check status
dina apps info -a my-app
dina apps logs -a my-app

Tips

• Apps must listen on port 8080. Always set PORT=8080 or configure the app to use port 8080.

Commands

Authentication

dina auth login
dina auth logout
dina auth status

Deploy

Deploy from source (zips and uploads current directory):

dina deploy -a my-app

Deploy a pre-built image:

dina deploy -a my-app --tag registry.example.com/my-app:v1.2

Deploy with replica count:

dina deploy -a my-app --replicas 3
dina deploy -a my-app --tag nginx:latest --replicas 2

Apps

# list all apps
dina apps list

# create a new app
dina apps create my-app

# show app details (URL, hostnames, latest deployment)
dina apps info -a my-app

# rename an app
dina apps update -a my-app --name new-name

# delete an app
dina apps delete -a my-app

Logs

# runtime logs (default 100 lines)
dina apps logs -a my-app
dina apps logs -a my-app -n 50

# build logs for a specific deployment
dina apps deployments -a my-app
dina apps deployments logs -a my-app --id <deployment-id>

Environment variables

dina apps env set -a my-app DATABASE_URL=postgres://localhost/mydb
dina apps env set -a my-app KEY1=val1 KEY2=val2

Custom hostnames

dina apps hostnames add -a my-app example.com
dina apps hostnames remove -a my-app example.com

Users (admin)

dina users list
dina users activate <user-id>

Other

dina version
dina check-update
dina update
dina install --skills

Common flag patterns

The -a / --app flag specifies the app name. It is required for most commands:

dina deploy -a my-app
dina apps info -a my-app
dina apps logs -a my-app
dina apps env set -a my-app KEY=value
dina apps hostnames add -a my-app example.com
dina apps deployments -a my-app
dina apps delete -a my-app

Example: Deploy a project from scratch

dina auth login
dina apps create my-api
dina apps env set -a my-api PORT=8080 DATABASE_URL=postgres://localhost/mydb
dina deploy -a my-api
dina apps logs -a my-api
dina apps hostnames add -a my-api api.example.com

Example: Deploy a pre-built image

dina apps create my-service
dina deploy -a my-service --tag ghcr.io/org/my-service:v1.0 --replicas 2
dina apps info -a my-service

Example: Debug a failing deployment

dina apps deployments -a my-app
dina apps deployments logs -a my-app --id <deployment-id>
dina apps logs -a my-app -n 200