# NEXUS AI Deployments

NEXUS AI accepts container, repository, and source deployments through its authenticated API, CLI, MCP server, and dashboard.

## Source deployment

The NEXUS CLI supports source deployment from a GitHub repository:

```bash
nexus deploy source --repo <GITHUB_REPOSITORY> --name <NAME>
```

The service must listen on the `PORT` environment variable. NEXUS health checks can target an HTTP path such as `/health`.

## Deployment lifecycle

The authenticated API exposes operations to:

- list deployments;
- get deployment status;
- read deployment logs;
- redeploy, start, or stop a deployment;
- scale a deployment;
- roll back a deployment; and
- delete a deployment.

These operations are permission- and token-scoped. Destructive actions must not be performed without explicit authorization.

## Providers and services

Source deployments can include PostgreSQL, MySQL, Redis, MongoDB, and worker services. The managed Container platform supports full-stack deployments. Cloud Run, AWS App Runner, and Azure Container Apps are supported for single-container deployments where configured.

Deployment configuration also supports health checks, environment variables, auto-destroy schedules, provider and region selection, build and start commands, and framework or Dockerfile overrides.

Framework detection covers FastAPI, Flask, Django, Express, Next.js, Rails, Laravel, Symfony, PHP, Ruby, Go, Java, and arbitrary container images where the deployment configuration is supported.

## API routes

The GPT-compatible API is hosted at `https://mcp.nexusai.run/api/gpt` and requires a NEXUS access token. See [API](/docs/api.md) and [OpenAPI](/openapi.json).

## Related resources

- [CLI](/docs/cli.md)
- [API](/docs/api.md)
- [MCP](/docs/mcp.md)
- [Security](/docs/security.md)