Skip to content

fcakyon/claude-codex-settings / plugins/openship-skills/skills/openship-deploy

openship-deploy

Verified

This 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.

references/cli/edge.mdx

View on GitHub
---
title: Manage the edge
description: Set up the reverse proxy, attach domains, apply rules, and inspect traffic.
---

The edge is Openship's reverse proxy and TLS layer. Use these commands with an authorized HTTP
context on a self-hosted installation. See [the edge guide](https://openship.io/docs/guides/the-edge) for the routing model.

## Inspect and set up

```bash
openship edge status
openship edge up
```

Running `openship edge` opens the interactive panel. The `up` command configures the managed edge;
its [reference](https://openship.io/docs/cli/reference/edge#openship-edge-up) lists target and setup options.

If another reverse proxy owns the HTTP/HTTPS ports, inspect its sites before taking over. Use
`edge takeover` or `edge migrate` only after reviewing their detected configuration and options.
The [existing-proxy guide](https://openship.io/docs/guides/the-edge#taking-over-a-server-thats-already-serving) explains the workflow.

## Domains and rules

```bash
openship edge domains list
openship edge rules list
openship edge sites
```

| Task | Reference |
| --- | --- |
| Add or remove edge hostnames | [Domain commands](https://openship.io/docs/cli/reference/edge#openship-edge-domains) |
| Add or remove access, redirect, or traffic rules | [Rule commands](https://openship.io/docs/cli/reference/edge/rules#openship-edge-rules) |
| Inspect sites managed outside project records | [Sites](https://openship.io/docs/cli/reference/edge#openship-edge-sites) |
| Repair managed edge configuration | [Repair](https://openship.io/docs/cli/reference/edge#openship-edge-repair) |

Project-owned custom domains can also be managed with [domain commands](https://openship.io/docs/cli/reference/domain).

## Inspect traffic

```bash
openship edge logs
openship edge traffic
openship edge analytics
```

The [command reference](https://openship.io/docs/cli/reference/edge) lists filters, time windows, and target options.
For certificate failures, see [DNS and TLS troubleshooting](https://openship.io/docs/troubleshooting/domains-ssl).
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 321kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 321kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 321kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall