Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Guidance for AI agents (Claude Code, Codex, Cursor, etc.) working in this reposi

## Repository

ObjectOS — the commercial runtime environment for ObjectStack applications (Cloud & Enterprise editions). This public repository is the product's front door: the marketing + docs site under `apps/docs` (content in `content/docs/`), the issue tracker, and the trademark policy. Product source is developed privately and does not live here.
ObjectOS — the runtime environment for ObjectStack applications, one product in three editions: Community (open source; its code lives in `objectstack-ai/objectstack`), Cloud and Enterprise. This public repository is the source of the product documentation site, docs.objectos.ai (a sub-site of www.objectos.ai): the docs site under `apps/docs` (content in `content/docs/`) and the trademark policy. It is not the product's issue tracker — that is `objectstack-ai/objectstack`; this repository takes issues about the documentation only. Cloud and Enterprise source is developed privately and does not live here.

## Critical rules

Expand Down
18 changes: 11 additions & 7 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Contributing to ObjectOS

ObjectOS is a **commercial product**; its source is developed privately.
This public repository hosts the **documentation site and issue tracker**.
Read this before opening a PR.
This public repository is the source of the **ObjectOS product
documentation** ([docs.objectos.ai](https://docs.objectos.ai)), a sub-site of
[www.objectos.ai](https://www.objectos.ai). Read this before opening a PR.

## What belongs here

Expand All @@ -13,13 +13,17 @@ Read this before opening a PR.
a bad translation? Open an issue, or fix the English source and the next pass
carries it through. See [docs/TRANSLATION.md](docs/TRANSLATION.md).
- **Docs site** improvements (`apps/docs/` — Next.js + Fumadocs).
- **Issues**: bug reports and feature requests for ObjectOS Cloud and
ObjectOS Enterprise.
- **Issues about the documentation itself** — a wrong page, a broken link,
a bad translation.

## What does NOT belong here

- **Product source changes** — ObjectOS itself is developed privately. Report
behavior as an issue instead.
- **Product issues and product source changes** — bug reports and feature
requests for ObjectOS Community, Cloud or Enterprise go to the one public
issue tracker,
[`objectstack-ai/objectstack`](https://github.com/objectstack-ai/objectstack/issues),
where the ObjectOS Community code also lives. ObjectOS Cloud and ObjectOS
Enterprise source is developed privately.
- **Framework changes** — protocol schemas, kernel internals, drivers, and
community plugins live in
[`objectstack-ai/objectstack`](https://github.com/objectstack-ai/objectstack)
Expand Down
91 changes: 52 additions & 39 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,53 +2,72 @@

> ## Build & ask online. Keep the data you own.
>
> **The ontology is the software.** ObjectOS is the **commercial runtime environment for
> [ObjectStack](https://github.com/objectstack-ai/objectstack) apps — built
> and operated entirely in the browser**: tell the built-in AI Builder what
> your business needs — a helpdesk, an approval flow, a CRM — and it's running
> immediately, with a generated admin Console, REST APIs, SSO, RBAC, and audit
> logs. No local toolchain, nothing to deploy. Run it as **ObjectOS Cloud**
> (we operate it) or **ObjectOS Enterprise** (self-managed: your servers, your
> database, your data — never ours).
> **The ontology is the software.** ObjectOS is the **runtime environment for
> [ObjectStack](https://github.com/objectstack-ai/objectstack) apps**: tell
> the built-in AI Builder what your business needs — a helpdesk, an approval
> flow, a CRM — and it's running immediately, with a generated admin Console,
> REST APIs, SSO, RBAC, and audit logs. One product, three editions: run it
> yourself for free as **ObjectOS Community** (open source), let us operate it
> as **ObjectOS Cloud**, or license it self-managed as **ObjectOS Enterprise**
> (your servers, your database, your data — never ours).

[Website](https://www.objectos.ai) ·
[Documentation](https://docs.objectos.ai) ·
[License & Pricing](https://docs.objectos.ai/docs/resources/license) ·
[ObjectStack — the open-source framework](https://github.com/objectstack-ai/objectstack)
[ObjectStack — the open-source protocol, SDK and framework](https://github.com/objectstack-ai/objectstack)

ObjectOS is a **commercial product**. This repository is its public home:
This repository is the source of the ObjectOS product documentation,
[docs.objectos.ai](https://docs.objectos.ai) — a sub-site of
[www.objectos.ai](https://www.objectos.ai), the ObjectOS home (the cloud
service included). It holds:

- 📚 **Documentation** — source for [docs.objectos.ai](https://docs.objectos.ai)
(`content/docs/`, built by `apps/docs/`), in seven languages.
- 🐛 **Issue tracker** — bug reports and feature requests for ObjectOS Cloud
and ObjectOS Enterprise.
- 📚 **Documentation** — `content/docs/`, built by `apps/docs/`, in seven
languages.
- ™️ **Trademark policy** — [TRADEMARK.md](TRADEMARK.md). The "ObjectOS" name
and logo are trademarks and are not covered by the code license.

The product source is developed privately and is not published in this
repository. There is no open-source edition of ObjectOS.
Product issues — for ObjectOS Community, Cloud or Enterprise — go to the one
public issue tracker,
[objectstack-ai/objectstack](https://github.com/objectstack-ai/objectstack/issues).
This repository takes issues about the documentation itself.

## Editions

One rate card, two deliveries — priced per **AI seat** in every edition:
## One product, three editions

| Delivery | Plans | For |
| Thing | Name | Terms |
|:---|:---|:---|
| **ObjectOS Cloud** (managed service) | Free · Team · Business | Organizations that want the platform operated for them — orgs, environments, deploys, billing. |
| **ObjectOS Enterprise** (self-managed: your infrastructure) | Business Self-Managed (single-node entry option) · Enterprise (full private deployment) | Organizations that run the platform themselves. |
| The protocol, SDK, CLI and framework code — the `@objectstack/*` packages, the [objectstack repository](https://github.com/objectstack-ai/objectstack) and the objectstack.ai docs | **ObjectStack** | Apache-2.0 |
| The open-source runtime and Console that run an app — the `ghcr.io/objectstack-ai/objectstack` image and `os start`; its code stays in the objectstack repository | **ObjectOS Community** | Free, Apache-2.0 |
| The hosted service, [cloud.objectos.ai](https://cloud.objectos.ai) — we operate it | **ObjectOS Cloud** | Free · Team |
| The self-managed edition on your own infrastructure, under a commercial license | **ObjectOS Enterprise** | Licensed |

Community has everything needed to run an app: the runtime, the Console,
permissions and sharing, audit, MCP, and every protocol capability. Cloud and
Enterprise add hosting and multi-environment operations, Build & Ask (the AI
Builder), SSO, and commercial support.

## Editions

- **ObjectOS Community** — open source, self-hosted, free (Apache-2.0).
- **ObjectOS Cloud** — the managed service: Free · Team.
- **ObjectOS Enterprise** — licensed, self-managed. Business and Business
Self-Managed (the single-node entry option) are contract options under it.

See [License & Pricing](https://docs.objectos.ai/docs/resources/license) for
plan details, and [docs.objectos.ai](https://docs.objectos.ai) for
capabilities, deployment, and operations documentation.

## Building and running your own apps? That's ObjectStack — and it's open source
## Run it yourself: ObjectOS Community

Everything you need to **build, run, and self-host your own applications** is
the open-source (Apache-2.0) **[ObjectStack framework](https://github.com/objectstack-ai/objectstack)**:
open source (Apache-2.0): the **[ObjectStack](https://github.com/objectstack-ai/objectstack)**
protocol, SDK, CLI and framework, and the ObjectOS Community runtime built
from them:

```
ObjectStack → build & ask with Claude Code — in your repo, with your coding agent (Apache-2.0)
ObjectOS → build & ask online — in the browser, on a governed platform (Cloud & Enterprise)
ObjectStack → build & ask with Claude Code — in your repo, with your coding agent (Apache-2.0)
ObjectOS Community → the open-source runtime + Console, self-hosted, free (Apache-2.0)
ObjectOS Cloud → build & ask online — in the browser, on a governed platform we operate
ObjectOS Enterprise → the same platform, licensed and self-managed on your infrastructure
```

`os start` — or the official Docker image
Expand All @@ -58,19 +77,13 @@ audit included. No commercial license required.

## What happened to the code that used to live here?

Until July 2026 this repository contained a free reference runtime
distribution (`@objectos/server`) and a desktop build (**ObjectOS One**).
As part of clarifying the ObjectStack / ObjectOS split:

- **`@objectos/server` is superseded** by the official ObjectStack runtime
image (`ghcr.io/objectstack-ai/objectstack`) — the same capability,
maintained where the runtime itself lives.
- **ObjectOS One is discontinued.** Demos and evaluations are served by the
official Docker image and ObjectOS Cloud trials.
- **Everything already released stays licensed as released**: historical
source remains available under Apache-2.0 in this repository's git history
(archive branch: [`archive/apache-final`](https://github.com/objectstack-ai/objectos/tree/archive/apache-final)).
Nothing is retroactively withdrawn.
Until July 2026 this repository shipped a free reference runtime distribution
(`@objectos/server`) and a desktop build (ObjectOS One); `@objectos/server`
was superseded by the official ObjectStack runtime image — today's ObjectOS
Community — and ObjectOS One was discontinued. Everything already released
stays licensed as released: the historical source remains available under
Apache-2.0 in this repository's git history (archive branch:
[`archive/apache-final`](https://github.com/objectstack-ai/docs.objectos.ai/tree/archive/apache-final)).

## Working on the docs

Expand Down
16 changes: 13 additions & 3 deletions TRADEMARK.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,11 @@

"ObjectOS" and the ObjectOS logo are trademarks of the ObjectOS project
maintainers. The Apache License 2.0 grants you broad rights to use,
modify, and redistribute the **code** in this repository, but it does
**not** grant rights to use the project's name or logo.
modify, and redistribute the **code** — this repository's site, and the
ObjectOS Community runtime distributed from the
[objectstack-ai/objectstack](https://github.com/objectstack-ai/objectstack)
repository — but it does **not** grant rights to use the project's name or
logo.

## You MAY

Expand All @@ -13,14 +16,21 @@ modify, and redistribute the **code** in this repository, but it does
- Use the name "ObjectOS" in unmodified documentation, tutorials, blog
posts, talks, and academic work that discusses the project.
- Distribute unmodified builds of ObjectOS under the name "ObjectOS".
**ObjectOS Community** is the named case: the open-source runtime and
Console distributed from the objectstack repository carry the ObjectOS
name and logo as shipped, and running that build for yourself — your own
deployment, modified or not — keeps the name.

## You MAY NOT (without prior written permission)

- Use "ObjectOS" or a confusingly similar name as part of the name of
your product, company, service, or domain.
- Use the ObjectOS logo as part of your own branding.
- Distribute a modified fork under the name "ObjectOS" in a way that
could mislead users into believing it is the official distribution.
could mislead users into believing it is the official distribution. This
includes a modified build of ObjectOS Community: redistributing one under
the ObjectOS name or with the ObjectOS logo requires permission, however
small the change.
- Imply official endorsement, partnership, or affiliation that does not
exist.

Expand Down
6 changes: 3 additions & 3 deletions apps/docs/app/[lang]/terms/page.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -21,15 +21,15 @@ const content = {
en: {
title: 'Terms of Service',
description: "How ObjectOS editions are licensed, the Apache-2.0 license of this site's content, the ObjectOS trademark, and responsibility for self-managed deployments.",
updated: 'Last updated: October 6, 2026',
updated: 'Last updated: October 26, 2026',
body: [
{
heading: 'License',
text: 'ObjectOS is a commercial product with no open-source edition. Your use of ObjectOS is governed by the license or service agreement of the edition you use — ObjectOS Cloud or ObjectOS Enterprise. The contents of the repository behind this documentation site (the documentation and the site code) are licensed under the Apache License 2.0, and the open-source ObjectStack framework and its runtime are licensed under the Apache License 2.0 in their own repository. The "ObjectOS" name and logo are trademarks of ObjectStack AI LLC and are not granted under the Apache 2.0 license — see TRADEMARK.md in the repository.',
text: 'ObjectOS is one product in three editions. ObjectOS Community, the open-source runtime and Console, is licensed under the Apache License 2.0 in the objectstack-ai/objectstack repository, together with the ObjectStack framework it is built on. Your use of ObjectOS Cloud or ObjectOS Enterprise is governed by the service agreement or license of that edition. The contents of the repository behind this documentation site (the documentation and the site code) are licensed under the Apache License 2.0. The "ObjectOS" name and logo are trademarks of ObjectStack AI LLC and are not granted under the Apache 2.0 license — see TRADEMARK.md in the repository.',
},
{
heading: 'Self-hosted deployments',
text: 'When you run ObjectOS self-managed inside your own infrastructure (ObjectOS Enterprise), you are solely responsible for the operation, security, availability, backups, and compliance of that deployment, and ObjectStack AI LLC provides no warranty for it beyond what your commercial agreement specifies. When you self-host the open-source ObjectStack runtime instead, it is licensed under the Apache License 2.0, and ObjectStack AI LLC provides no warranty beyond what that license specifies.',
text: 'When you run ObjectOS self-managed inside your own infrastructure (ObjectOS Enterprise), you are solely responsible for the operation, security, availability, backups, and compliance of that deployment, and ObjectStack AI LLC provides no warranty for it beyond what your commercial agreement specifies. When you self-host ObjectOS Community instead, it is licensed under the Apache License 2.0, and ObjectStack AI LLC provides no warranty beyond what that license specifies.',
},
{
heading: 'Hosted services',
Expand Down
7 changes: 4 additions & 3 deletions content/docs/architecture.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -47,9 +47,10 @@ metadata after a HITL approval.

## What you deploy

One Node.js process, serving one app. That's it. On ObjectOS Cloud we run
that process for you; on ObjectOS Enterprise you deploy it, from the
licensed runtime image described under [Deployment](/docs/deploy).
One Node.js process, serving one app. That's it. On ObjectOS Community you
run that process yourself from the open-source image (`os start`); on
ObjectOS Cloud we run it for you; on ObjectOS Enterprise you deploy it from
the licensed Enterprise image described under [Deployment](/docs/deploy).

```text
┌─────────────────────────────────────────────────────┐
Expand Down
2 changes: 1 addition & 1 deletion content/docs/configure/email.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ deployment) you have two production-grade options:
in the spec repo.

Native SMTP transport is on the roadmap; track progress at
[github.com/objectstack-ai/objectos/issues](https://github.com/objectstack-ai/objectos/issues).
[github.com/objectstack-ai/objectstack/issues](https://github.com/objectstack-ai/objectstack/issues).

## Environment variables

Expand Down
8 changes: 4 additions & 4 deletions content/docs/deploy/docker.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Docker
seoTitle: "Docker: Run the Licensed Runtime Image by Digest"
description: Run the licensed ObjectOS runtime image with Docker — digest-pinned, signature-verified, licensed, and scaled to multiple replicas.
seoTitle: "Docker: Run the ObjectOS Enterprise Image by Digest"
description: Run the ObjectOS Enterprise runtime image with Docker — digest-pinned, signature-verified, licensed, and scaled to multiple replicas.
---

Docker is the supported way to run ObjectOS Enterprise. Your release ships a
Expand Down Expand Up @@ -72,8 +72,8 @@ issuer to check against, matched to your release.
**A license is part of the happy path.** How the runtime behaves without one
depends on what you asked it to be:

- **Single-organization, no license** — the deployment runs with Community
behaviour: the open MCP server, bring your own AI. Nothing bricks.
- **Single-organization, no license** — the deployment runs as ObjectOS
Community: the open MCP server, bring your own AI. Nothing bricks.
- **Single-organization, licensed** — the in-product AI is unlocked on your
own infrastructure: the AI Builder and "ask your data".
- **Multi-organization (a walled tenancy posture), no license** — the runtime
Expand Down
9 changes: 5 additions & 4 deletions content/docs/deploy/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,11 @@ pre-built runtime image** — on a single node as Business Self-Managed, or as a
full Enterprise deployment.
You do not build it, and there is no public image to pull: your license comes
with registry credentials, and the release notes name the exact image digest
to run. (ObjectOS is a commercial product — see
[License & Pricing](/docs/resources/license). If you are looking for a free
self-hosted runtime, that is the open-source ObjectStack framework, a
different product.)
to run. (If you are looking for the free self-hosted edition, that is
**ObjectOS Community** — the open-source runtime image
`ghcr.io/objectstack-ai/objectstack` and `os start`, which the
[Quickstart](/docs/quickstart) boots; see
[License & Pricing](/docs/resources/license) for how the editions differ.)

## Every deployment decides three things

Expand Down
2 changes: 1 addition & 1 deletion content/docs/deploy/kubernetes.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Kubernetes
seoTitle: "Kubernetes: Digest Pinning, Migrations, Probes"
description: What any orchestrator must preserve to run the licensed ObjectOS image — digest pinning, migration ordering, probes, and what multi-replica makes mandatory.
description: What any orchestrator must preserve to run the ObjectOS Enterprise image — digest pinning, migration ordering, probes, and what multi-replica makes mandatory.
---

**We ship a Compose stack, not a Helm chart or Kubernetes manifests.** The
Expand Down
Loading
Loading