Deploy Your First App

This guide walks you through the full lifecycle of an app on Zerokie: creating it, checking its status, redeploying, and deleting it.

Create an app

Deploy a public Docker image with a single command:

zerokie apps create --name my-app --image nginx:alpine --port 80

Expected output:

App created: my-app
URL:         https://my-app.platform-dev.zerokie.com
Status:      deploying

Your app will be available at the URL within a few seconds, with a valid Let’s Encrypt TLS certificate.

Check status

zerokie apps status my-app

Name:       my-app
Image:      nginx:alpine
Port:       80
Status:     running
URL:        https://my-app.platform-dev.zerokie.com
Instances:  1
CPU:        256 MHz
Memory:     512 MB

List all apps

zerokie apps list

NAME    IMAGE         STATUS   URL
my-app  nginx:alpine  running  https://my-app.platform-dev.zerokie.com

Redeploy

After pushing a new version of your Docker image, trigger a redeployment:

zerokie apps deploy my-app

Zerokie pulls the latest version of the image and performs a rolling update.

Delete an app

When you no longer need the app:

zerokie apps delete my-app

This stops the running container and removes the DNS record.

Deploy a static site

Zerokie also supports static sites served directly from a CDN — no containers needed.

Create a static app

zerokie apps create --name my-site --type static

App created: my-site
URL:         https://my-site.platform-dev.zerokie.com
Type:        static

Deploy your files

Point the CLI at a directory containing your built site (e.g. ./dist, ./public, ./build):

zerokie apps deploy my-site --dir ./dist

Deploying to my-site...
Uploaded:  42 files (1.2 MB)
Deleted:   0 files
URL:       https://my-site.platform-dev.zerokie.com

Your site is live and served via CDN with automatic TLS.

Add a custom domain

zerokie domains add my-site www.example.com

Domain added: www.example.com
CNAME target: my-site.platform-dev.zerokie.com
TLS status:   pending

Create a CNAME record with your DNS provider:
  www.example.com → my-site.platform-dev.zerokie.com

TLS is provisioned automatically once the CNAME record is in place (typically 1-10 minutes).

Next steps

• Learn how to pass environment variables to your apps.
• Configure resource limits for CPU and memory.
• Read the Static Hosting guide for the full static site workflow.