fcakyon/claude-codex-settings / plugins/openship-skills/skills/openship-deploy
openship-deploy
VerifiedThis skill should be used when the user asks to "deploy with OpenShip", "manage a self-hosted OpenShip instance", "debug an OpenShip deployment", or manage its domains, storage, backups, or upgrades through the CLI.
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 11.1 KB |
| SKILL.md | skill md | 4.0 KB |
| references/cli/access.mdx | markdown | 7.6 KB |
| references/cli/automation.mdx | markdown | 3.4 KB |
| references/cli/deploy.mdx | markdown | 4.4 KB |
| references/cli/edge.mdx | markdown | 2.0 KB |
| references/cli/index.mdx | markdown | 3.2 KB |
| references/cli/projects.mdx | markdown | 5.1 KB |
| references/cli/run.mdx | markdown | 2.6 KB |
| references/cli/self-host.mdx | markdown | 4.7 KB |
| references/guides/backups-restore.mdx | markdown | 12.9 KB |
| references/guides/custom-domains.mdx | markdown | 22.3 KB |
| references/guides/logs-monitoring.mdx | markdown | 11.8 KB |
| references/guides/migrate-control-plane.mdx | markdown | 10.4 KB |
| references/guides/persistent-storage.mdx | markdown | 7.0 KB |
| references/guides/rollback-redeploy.mdx | markdown | 16.3 KB |
| references/guides/self-hosted-github-app.mdx | markdown | 6.6 KB |
| references/guides/updating.mdx | markdown | 8.1 KB |
| references/troubleshooting/deployments.mdx | markdown | 18.0 KB |
| references/troubleshooting/domains-ssl.mdx | markdown | 16.4 KB |
| references/upstream.json | config | 7.6 KB |
references/cli/projects.mdx
View on GitHub---
title: Projects, services, and domains
description: Manage application configuration and related resources from the CLI.
---
Resource commands use the active [connection context](https://openship.io/docs/cli/access) or your selected
[native configuration](https://openship.io/docs/cli/native).
## Projects
```bash
openship project list
openship project create --name my-app --git-owner my-team --git-repo my-app
openship project get proj_123
openship project rename proj_123 "My application"
openship init --project proj_123
```
`project rename` updates the display name through the same operation as the dashboard.
The project ID, slug, volumes, and live routes keep their existing identities. Manage hostnames
with the domain commands below.
`init` writes a project link in `.openship/project.json`. This is different from `openship.json`, which
declares deployment configuration:
```bash
openship config init
openship config validate
```
See [project commands](https://openship.io/docs/cli/reference/project), [link options](https://openship.io/docs/cli/reference/init), and
[configuration commands](https://openship.io/docs/cli/reference/config).
Links record their context, API and any explicit organization scope. Commands reject a mismatched
connection before using the linked project. Pass `--project` to deliberately select a different target,
or run `init --force` to replace the link.
## Environment and source settings
```bash
openship project env get proj_123
openship project git branch proj_123 main
openship project sleep-mode proj_123 always_on
openship project environment create proj_123 Preview --type preview --branch feature
openship project environment list proj_123
openship project resources get proj_123
openship project resources set proj_123 resources.json
```
Use the project reference for environment writes, auto-deploy, release images, logs, and project
teardown. [Environment variables](https://openship.io/docs/guides/environment-variables) explains secret handling and
when changes reach a running application.
`project environment create` returns a **separate project ID** with its own runtime. Link or deploy that
ID to use it. `project resources set` accepts a JSON patch such as
`{"production":{"cpuCores":1,"memoryMb":1024}}`; the engine enforces the destination's capacity and policy.
Use `project update <id> <file>` for other build/runtime configuration, `project storage` for object storage
bindings, and `project connections` to wire app outputs into another project's variables.
## Services
```bash
openship service list --project proj_123
openship service get svc_123 --project proj_123
openship service logs svc_123 --project proj_123 --follow
openship service env set svc_123 MODE=production --project proj_123
openship service env inspect svc_123 --project proj_123 --runtime
openship service env apply svc_123 --project proj_123
```
Services belong to a project. Supply the required `--project` flag. The [service reference](https://openship.io/docs/cli/reference/service)
covers creation, Compose synchronization, drift decisions, environment variables, runtime controls, and execution.
Ordinary `env set` changes only the named overrides. `--secret` marks supplied values as secret;
omitting it preserves existing secret classification. `--replace` explicitly replaces all overrides for
the selected variable set. `env delete` removes selected overrides, exposing any inherited values again.
Saving and deleting variables do not restart the service. `env apply` uses the engine's existing container
replacement and rollback workflow; `restart` alone does not apply pending environment changes.
`env inspect` shows effective values with secrets masked and checks the running container only with
`--runtime`. `env reveal <service> <keys...>` explicitly reveals selected values and requires write access.
Use `service update <service> <file> --project <id>` for a JSON configuration patch, including image,
command, build settings, routing, ports and enabled state.
## Domains
```bash
openship domain add app.example.com --project proj_123
openship domain records dom_123
openship domain verify dom_123
openship domain verify-ssl dom_123
```
Follow the returned DNS instructions before verification. See [domain options](https://openship.io/docs/cli/reference/domain)
and the [custom-domain guide](https://openship.io/docs/guides/custom-domains) for DNS providers, TLS, and primary domains.
`dns providers`, `dns credentials` and `dns verify-zone` manage automated DNS access. Use
`domain dns plan` before `domain dns apply` to inspect provider record changes. For DNS certificate
challenges, use `domain dns challenge start`, inspect with `get`, and pass the returned attempt ID to
`check` or `cancel`. Manual challenges require the operator to add the TXT record, including at renewal.
## Catalog apps
```bash
openship app list
openship app get postgres
openship app host-fit postgres --server srv_123
```
`app install` creates an installation draft. Deploy the returned project ID with `openship deploy`.
Custom app definitions, curated settings, and connection details are covered in the
[app reference](https://openship.io/docs/cli/reference/app).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |