Eve Project Bootstrap

Eve Project Bootstrap

Use this flow to connect an existing repo to Eve and get the first deploy running.

Set the API Target

• Get the staging API URL from your admin.
• Create and use a profile:

eve profile create staging --api-url https://api.eve.example.com
eve profile use staging

Create Org and Project

eve org ensure my-org --slug myorg
eve project ensure --name "My App" --slug my-app --repo-url git@github.com:me/my-app.git --branch main

URL impact: These slugs determine your deployment URLs and K8s namespaces:

• URL: {service}.{orgSlug}-{projectSlug}-{env}.{domain} (e.g., api.myorg-my-app-staging.eve.example.com)
• Namespace: eve-{orgSlug}-{projectSlug}-{env} (e.g., eve-myorg-my-app-staging)

Slugs are immutable — choose short, meaningful values.

Set defaults:

eve profile set --org org_xxx --project proj_xxx

Add the Manifest

• Ensure .eve/manifest.yaml is present and uses schema: eve/compose/v1.
• Use the eve-manifest-authoring skill for structure details.

First Deploy

# Create environment if needed
eve env create staging --project proj_xxx --type persistent