Deploy CosmicAC

Verify the prerequisites

Enable Docker, then confirm you have everything listed in Prerequisites:

sudo systemctl enable --now docker
docker compose version
task --version
node --version
kubectl version --client

Set up the environment

Clone the deployment repository and change into it:

git clone <deployment-repo-url>
cd <deployment-repo>

Create the .env file from the example:

cp .env.example .env

In .env, set the variables your deployment needs. See Required before the first deployment for the ones you must set, and the deployment configuration for the rest.

Add the kubeconfig

Get the kubeconfig from your cluster administrator. It must meet the Kubeconfig requirements.

Open a file on the host, paste the kubeconfig, and save it:

nano ~/kubeconfig

Print the file's absolute path:

realpath ~/kubeconfig

Set KUBECONFIG_SRC in .env to that path:

KUBECONFIG_SRC=/home/<user>/kubeconfig

Confirm the kubeconfig is readable and reaches your cluster:

test -s ~/kubeconfig && echo ok
kubectl --kubeconfig ~/kubeconfig config current-context
kubectl --kubeconfig ~/kubeconfig cluster-info

Run the first-time bootstrap

task bootstrap deploys the whole stack with one command, using TAG from .env. For what it runs and the other deployment commands, see Task deployment commands.

Print the deployment directory and copy the path:

pwd

Open a root shell:

sudo -i

A root shell starts in root's home directory, so return to the copied path:

cd <copied-path>

Run the bootstrap:

task bootstrap

Verify the deployment

Check the services and the API:

task ps
curl -s4 -o /dev/null -w '%{http_code}\n' http://127.0.0.1:5173/
curl -s4 "http://127.0.0.1:5173/api/auth/servers?overwrite_cache=true"
curl -s4 "http://127.0.0.1:5173/api/auth/pricing?location=IN&type=gpu&hrs=2"
curl -s4 "http://127.0.0.1:5173/api/auth/jobs?page=1&pageSize=10"

The calls carry no token because a default deployment runs with authentication turned off.

The deployment is healthy when task ps shows every service Up and http://127.0.0.1:5173/ returns 200. The servers call lists your GPUs, and the pricing call returns a total cost rather than an error.

Open the web interface

Open http://<server-ip>:5173 in your browser. If you changed UI_PORT, use that port instead.