{"id":50277410,"url":"https://github.com/compartmentdev/compartment","last_synced_at":"2026-05-27T22:00:34.677Z","repository":{"id":360452495,"uuid":"1249523448","full_name":"compartmentdev/compartment","owner":"compartmentdev","description":"Compartment is a self-hosted application deployment system for teams that want to ship and share internal, private, or public web apps without building their own platform stack.","archived":false,"fork":false,"pushed_at":"2026-05-26T14:19:42.000Z","size":3046,"stargazers_count":0,"open_issues_count":8,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-26T14:23:19.568Z","etag":null,"topics":["audit-log","automation","deployment","developer-tools","docker","enterprise","hosting","internal-tools","rbac","security","self-hosted","sso"],"latest_commit_sha":null,"homepage":"https://compartment.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/compartmentdev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-25T19:44:47.000Z","updated_at":"2026-05-26T14:01:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/compartmentdev/compartment","commit_stats":null,"previous_names":["compartmentdev/compartment"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/compartmentdev/compartment","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compartmentdev%2Fcompartment","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compartmentdev%2Fcompartment/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compartmentdev%2Fcompartment/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compartmentdev%2Fcompartment/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/compartmentdev","download_url":"https://codeload.github.com/compartmentdev/compartment/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compartmentdev%2Fcompartment/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33585203,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audit-log","automation","deployment","developer-tools","docker","enterprise","hosting","internal-tools","rbac","security","self-hosted","sso"],"created_at":"2026-05-27T22:00:17.961Z","updated_at":"2026-05-27T22:00:34.661Z","avatar_url":"https://github.com/compartmentdev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\".github/assets/compartment-logo-white.svg\" /\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\".github/assets/compartment-logo-black.svg\" /\u003e\n    \u003cimg src=\".github/assets/compartment-logo-black.svg\" alt=\"Compartment\" width=\"360\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eCompartment\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  Self-hosted deployment infrastructure for internal tools, private apps, and public services.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://docs.compartment.dev/\"\u003eDocs\u003c/a\u003e\n  ·\n  \u003ca href=\"#quickstart\"\u003eQuickstart\u003c/a\u003e\n  ·\n  \u003ca href=\"#developing-locally\"\u003eDeveloping locally\u003c/a\u003e\n  ·\n  \u003ca href=\"./CONTRIBUTING.md\"\u003eContributing\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/compartmentdev/compartment/actions/workflows/ci.yml\"\u003e\n    \u003cimg alt=\"CI\" src=\"https://github.com/compartmentdev/compartment/actions/workflows/ci.yml/badge.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"./LICENSE\"\u003e\n    \u003cimg alt=\"License: Apache 2.0\" src=\"https://img.shields.io/badge/license-Apache--2.0-blue\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## What Is Compartment?\n\nCompartment is a self-hosted deployment system for teams that need a controlled place to run software on their own infrastructure. It provides the runtime, URLs, access model, deployment history, and operations surface around applications that already live in normal repositories.\n\nThe project is CLI-first and repository-first. Add a `compartment.yml`, deploy from a checkout or connected Git repository, and run the result through a self-hosted control plane. If an app can build into a container image with Docker or [Railpack](https://railpack.com/), it can usually fit the Compartment model.\n\n## Why Teams Use It\n\nTeams use Compartment when software that started as a script, internal app, worker, or AI-generated tool becomes useful enough that it needs a stable place to run.\n\n- Share team software without ad hoc links, manual handoffs, or unclear ownership.\n- Keep runtime control on infrastructure the team owns, without turning sustained compute or traffic into managed-platform spend.\n- Govern access with SSO, RBAC, roles, and audit logs instead of informal permission paths.\n- Run tools close to private services, data stores, and internal APIs while keeping workloads isolated.\n- Move from repository code to a working app without building a custom platform stack first.\n\n## Quickstart\n\nOn the target server, install the CLI and initialize the Compartment system:\n\n```bash\ncurl -fsSL https://compartment.dev/install.sh | sh -s -- --init-install\n```\n\nPrepare an application repository:\n\n```bash\ncompartment init\n```\n\nThe smallest descriptor looks like this:\n\n```yaml\nname: internal-tools\n\nservices:\n  web: .\n```\n\nDeploy and inspect the result:\n\n```bash\ncompartment deploy\ncompartment status\ncompartment logs\n```\n\nFor branch-driven deploys, connect the repository through the Console or with `compartment source connect git`. See [Deploy using Git](https://docs.compartment.dev/deploy-apps/deploy-using-git/) for the full flow.\n\n## Repository Layout\n\n| Path                 | Purpose                                                                         |\n| -------------------- | ------------------------------------------------------------------------------- |\n| `packages/cli`       | User-facing `compartment` command implementation.                               |\n| `packages/sdk`       | SDK client surface used by the CLI and other clients.                           |\n| `packages/contracts` | Shared public contracts, schemas, paths, and generated reference inputs.        |\n| `packages/api`       | Control-plane API, auth, persistence, migrations, and server-owned web serving. |\n| `packages/console`   | Vite and React browser control plane.                                           |\n| `packages/worker`    | Deployment execution and background work.                                       |\n| `packages/node`      | Runtime-node control surface for deployed services.                             |\n| `packages/edge`      | Hosted-app ingress and access enforcement boundary.                             |\n| `public-docs`        | Public Starlight documentation site.                                            |\n| `docs`               | Internal architecture, package ownership, and operating specs.                  |\n| `examples`           | Example applications and descriptor fixtures.                                   |\n\n## Developing Locally\n\nUse the Node version pinned in `.nvmrc` and the pnpm version declared in `package.json`.\n\n```bash\nnvm use\npnpm install\ncp .env.example .env\n```\n\nLocal development expects PostgreSQL from `COMPARTMENT_DATABASE_URL`, plus `caddy` and `railpack` on `PATH`:\n\n```bash\nbrew install caddy\ncurl -sSL https://railpack.com/install.sh | sh\npnpm dev\n```\n\nRead [docs/specs/local-development.md](./docs/specs/local-development.md) before changing local runtime behavior.\n\n## Contributing\n\nStart with [CONTRIBUTING.md](./CONTRIBUTING.md). The short version:\n\n- Keep changes package-owned and scoped to one behavior.\n- Start new product behavior from the CLI command and shared SDK/API contract.\n- Read the relevant file under [docs/layers](./docs/layers/) before editing a package.\n- Update public docs when shipped user-visible behavior changes.\n- Run the narrowest relevant lint, typecheck, and test commands for the package you touched.\n\n## Useful Links\n\n- [Homepage](https://compartment.dev/)\n- [Documentation](https://docs.compartment.dev/)\n- [Docker Hub](https://hub.docker.com/orgs/compartmentdev)\n\n## License\n\nCompartment is licensed under the [Apache License 2.0](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcompartmentdev%2Fcompartment","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcompartmentdev%2Fcompartment","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcompartmentdev%2Fcompartment/lists"}