FAQ: Setup, Multi-tenancy, Pricing and Licensing

Common questions about ObjectOS — getting started, databases and multi-tenancy, migrations, permissions, integrations, operations, pricing and licensing.

Getting started

What's the absolute fastest way to try ObjectOS?

Sign in to ObjectOS Cloud — hosted in the browser, nothing to install. To run the open-source ObjectStack runtime on your own machine instead, npm i -g @objectstack/cli && os start and open http://localhost:3000. See Quickstart.

Do I need Docker?

No. ObjectOS Cloud needs nothing installed. For the open runtime, Node 22+ and the CLI are enough; Docker is the recommended shape for a self-managed production deployment.

Do I need a database?

No, not to start — ObjectOS Cloud is managed for you, and the open runtime uses local SQLite by default. A self-managed deployment swaps in Postgres / MySQL / Turso / Mongo when it goes to production.

Do I need an account / cloud service?

ObjectOS Cloud is the account: sign in and build. ObjectOS Enterprise is self-managed and needs no cloud service to run — connecting it to a control plane is optional. The open-source ObjectStack runtime needs no account at all.

Architecture

Can I use Postgres / MySQL / MongoDB?

Yes — Postgres, MySQL, SQLite, Turso/libSQL, and MongoDB are supported drivers. See Runtime Configuration.

Can I disable the UI / Account portals and use only the REST API?

Yes. Run os start --no-ui or set the corresponding flags. The REST API is the same whether the UIs are mounted or not.

Can I use my own front-end instead of the generated UI?

Yes. The generated UI uses the same /api/v1/* endpoints you'd call from your own code. Use @objectstack/client SDK or any HTTP client.

Does ObjectOS support GraphQL?

No. REST is the API surface. The GraphQL endpoint was removed in ObjectStack 17.0 — it had never been implemented behind the route, and /graphql now returns 404. Use the generated REST API with the ObjectQL query language (over ?filter= / ?sort= / ?expand=), which covers the same ground. A third-party system that speaks GraphQL is unaffected: graphql remains a valid protocol for an external datasource, which is a client of someone else's API rather than a surface ObjectOS serves.

How is multi-tenancy handled?

One deployment serves one app, against one database — see Architecture. Several organizations can share that deployment: a walled tenancy posture (OS_TENANCY_POSTURE) puts up the per-organization isolation wall, and it is a licensed capability the runtime refuses to start without. What the wall separates is the organizations' data and memberships, not the metadata — schema is scoped to the deployment, not to an organization, which is why a walled deployment must also declare which AI agents are mounted. Isolation stronger than the wall is deployment separation: a customer that must have its own database gets its own deployment. See Multi-organization deployments.

Can ObjectOS run in a serverless / Lambda environment?

The runtime is a long-lived Node process — designed for containers or VMs, not stateless functions. The kernel is built at startup and the process reports ready only afterwards; that warm in-process state, and the Better Auth session model, are what a per-invocation function cannot keep.

Does it scale horizontally?

Yes. Run multiple instances behind a load balancer. Sessions live in the database (not in-memory), so any instance can serve any request. Use Redis for shared rate limiting and queue if you enable those capabilities.

Data & migrations

How are schema migrations handled?

The driver syncs the database schema to your declared objects on boot. For Postgres, that's CREATE TABLE / ALTER TABLE statements. For controlled migrations in regulated environments, set OS_SKIP_SCHEMA_SYNC=1 and manage DDL yourself.

What happens to data when I rename a field?

A rename is a destructive change at the data layer (it looks like "drop old column, add new column"). Use os diff to detect this and add a migration step (rename column in DB before deploying the new artifact).

Can I import data from CSV / Excel / Salesforce?

CSV: yes, via os data create in a loop or the bulk upload in the UI. Salesforce: best path today is to export to CSV and import. Native connectors are on the roadmap.

Will upgrading ObjectOS lose my data?

No. Patch and minor upgrades are non-destructive. Major upgrades (e.g. 4 → 5) document required migrations explicitly. Back up first — Backup & DR.

Permissions & multi-tenancy

How do I do row-level security?

Declare a sharing rule (declarative, like Salesforce) or a CEL predicate on an object's recordAccess config. The security plugin injects the corresponding filter on every query. See Permissions.

Can I make some fields invisible to certain users?

Yes — field-level security in permission sets. Hide or read-only, per field per permission set. Enforced uniformly across REST, ObjectQL, and the UI. See Permission Sets.

How do I integrate Okta / Entra / Keycloak?

OIDC. Configure the discovery URL + client id/secret in Setup → Authentication (or via env). Provider callback URL is /api/v1/auth/oauth2/callback/<provider-id>. See Authentication.

Integrations

Can I send webhooks?

Yes — enable webhooks in requires. ObjectOS uses a persistent outbox with HMAC-SHA256 signing. See Webhooks.

Can I integrate with Zapier / Make / n8n?

Yes — webhooks for outbound and the REST API + API keys for inbound. Native connectors for popular iPaaS tools are on the roadmap.

Can AI agents call my ObjectOS?

Yes, via MCP (@objectstack/mcp) — exposes objects (and, increasingly, actions) as MCP tools that Claude Desktop, IDEs, Claude Code, or any other MCP client can use. This is the AI path on the free, open-source ObjectStack framework (bring your own model); the in-product AI Builder / "ask your data" assistant is what the paid ObjectOS editions add. See AI Service.

Customization

Can I write custom plugins?

Yes — plugins follow a simple DI + lifecycle pattern (init → start → destroy). See @objectstack/plugin-* packages on GitHub for examples.

Can I customize how ObjectOS looks?

Branding (logo, accent color, default theme) is in Setup → System Settings. Deep UI customization means forking @objectstack/client-react or building your own front-end against the REST API.

Can I add languages other than English?

Yes — i18n is first-class. Use os i18n extract / os i18n check and ship a translation bundle.

Operations

What's the recommended production deployment?

Docker (or Kubernetes for multi-pod) + managed Postgres + S3 or R2 for files + your secret manager for OS_AUTH_SECRET. See Production Readiness.

Does ObjectOS have a status page?

For a self-managed (Enterprise) deployment, status is your concern — point your monitor at /api/v1/health for liveness and /api/v1/ready for readiness, the pair Docker and Kubernetes wire up. For hosted services, see status.objectstack.ai.

What metrics should I monitor?

5xx rate, p95 latency, readiness (/api/v1/ready). There is no auth-failure metric to monitor — review sign-in activity in Setup's Auth audit view instead. Minimal Prometheus example in Observability.

How do I take a backup?

Back up the database and the storage bucket — those hold all customer data. ObjectOS itself is stateless. See Backup.

Pricing & legal

Is ObjectOS free?

ObjectOS is a commercial product (there is a free Cloud tier to start on). The free, self-hostable platform is the open-source ObjectStack framework (Apache-2.0): no seats, no usage tier, no license server — with AI over MCP (bring your own model). ObjectOS adds the embedded in-UI AI + governance and official operations, and you pay only for AI seats (viewers and non-AI users are free). See Editions.

FAQ

En esta página