Skip to content

OriginChainDB / Questions & answers

Find the answer.
Follow the details.

Data models, deployment, pricing and the limits to understand before you build.

Getting started

What OriginChainDB is, what you get, and how to pick a starting point.

What is OriginChainDB?

OriginChainDB is a distributed multimodal database for SQL records, vector search, full-text search and graph relationships. Ask adds a natural-language query interface over the engine. Explore the database.

Link to this answer

What do I get when I sign up?

A provisioned database has an HTTPS endpoint and credentials for its supported API surfaces. Free uses shared infrastructure; dedicated configurations have their own compute and storage. Review the selected configuration and follow the quickstart for your first request.

Link to this answer

How much does OriginChainDB cost?

Free includes 1 GB of database storage. Two pooled configurations are available: $29/month for 25 GB storage and 20 GB monthly data transfer, or $49/month for 50 GB storage and 50 GB transfer. Dedicated pricing depends on resources, region and options. Compare configurations and estimates.

Link to this answer

Which regions can I deploy to?

Check the regions available for the configuration you select in the console. Dedicated database resources are provisioned in the selected region; account and billing services are global. The pooled configurations are scoped to India (Mumbai). Read the deployment guide.

Link to this answer

How do I sign up and get my first connection?

Create an account at app.originchaindb.com, select an available configuration and review its requirements. Once provisioned, use the instance endpoint and credential from the console. Keep credentials on your server and follow the first-query guide.

Link to this answer

Why is the dashboard on a different domain?

The public website at originchaindb.com and the authenticated console at app.originchaindb.com are separate applications. Use the website for product information and documentation, and the console for your account and instances.

Link to this answer

Free, Starter or dedicated — which should I pick?

Use Free for learning and prototypes. The 25 GB and 50 GB pooled configurations provide fixed monthly shared capacity; choose your configuration in the console. Choose a dedicated configuration when you need your own compute and storage, with recovery and standby options reviewed separately. Compare the current options.

Link to this answer

Console & tutorials

Find your way around the console, follow a video guide and get help with a step.

Where do I start in the new console?

Sign in at app.originchaindb.com, choose your organization, then open an instance. Overview has its status and connection details; Workbench runs queries; Data Explorer browses tables and records. Database Management, Access Control, Configuration and Platform contain the instance’s other tools. Watch the console overview on YouTube. Read the current console guide.

Link to this answer

Can I try the console without connecting a real database?

Yes. The demo workspace uses sample organizations, instances and data in your browser. It cannot connect to real instances. To work with your own data, open sign-in from the demo and sign in to the real console; values entered in the demo are not carried over.

Link to this answer

How do I create an instance and find its connection details?

Open Instances in your organization and choose Create instance. Review the available configuration and its requirements, then follow the console’s provisioning steps. Once the instance is ready, open Overview and Connect for its endpoint, tenant and available connection methods. Store any key or token when it is shown. Watch the instance configuration and connection guide on YouTube.

Link to this answer

When should I use Workbench instead of Data Explorer?

Use Workbench to write and run queries against the selected instance. Use Data Explorer to inspect namespaces, tables, fields and records, and to open a table’s query. Query support depends on the selected API and configuration. Watch the Workbench tutorial on YouTube.

Link to this answer

Why can I see a table but not edit its records?

Data Explorer can display tables that its record editor cannot safely update, including some tables without a primary key or with a composite key. These open read-only with a reason. Your role can also limit editing. Check the explanation shown for the table or action before using another supported API. Watch the Data Explorer tutorial on YouTube.

Link to this answer

Why is a console button disabled or waiting?

Check the reason beside the action: your role, the instance state or the selected configuration can make a control unavailable. Workbench and Data Explorer wait while a sleeping instance wakes. Ask an organization administrator about missing permissions. If a control remains unresponsive after its stated requirements are met, contact the team with the page, action and error message, leaving out credentials. Watch the roles and row policies guide on YouTube.

Link to this answer

Can I view an instance key or token again after closing it?

Treat a newly issued key or token as a one-time secret. The console keeps it visible until you confirm that you have stored it. Save it securely before continuing. If it is lost, use the permitted key or token management action to issue a replacement and update applications that use it; do not expect the old secret to be shown again.

Link to this answer

Where do I find setup instructions for a client or integration?

Open Integrations in your organization, choose the instance, then search or browse the tool groups. Each available integration has setup guidance. Use that instance’s Connect dialog for its actual connection details, and review the linked documentation for the operations supported by the chosen client.

Link to this answer

What if a tutorial video looks different from my console or leaves a question unanswered?

Videos show the workflow available when they were recorded; newer options, permissions and configuration limits can differ. Start with the tutorial library, then check the current console’s guidance and the documentation for the step you are following. If you still need help, send the team the video link, timestamp, step title and error message. Leave out passwords, tokens and private data.

Link to this answer

Capabilities

Data models, query interfaces, transactions and supported operations.

Can I use an Elasticsearch client with my instance?

Dedicated deployments expose a supported subset of the Elasticsearch-compatible API for 7.x clients. Use the instance HTTPS endpoint followed by /v1/tenants/{tenant}/es, with the tenant ID shown in Connect. Authentication accepts an OriginChainDB token as Bearer, as the password in Basic authentication, or in the ApiKey header format. This does not establish compatibility with every client operation or Kibana. Read the Elasticsearch connection guide. Check current support and authentication.

Link to this answer

Is the vector record API available on my configuration?

The vector record API is available on dedicated deployments with the required vector capability enabled. It supports indexes, namespaces, dense and sparse vectors, and metadata. It is separate from the existing vector-table API and is not available on the Free configuration. A Pinecone-compatible endpoint and SDK compatibility are not available yet. Read the vector record API reference.

Link to this answer

What query shapes does OriginChainDB support?

The four data models are SQL records, vectors, full-text indexes and graph relationships. Ask is a natural-language interface, not a fifth storage model. Each API has its own supported operations and limits; the documentation shows the request and result shapes.

Link to this answer

What are 'atomic cross-shape writes'?

Atomicity applies to the writes included in a supported operation or transaction. A row update does not automatically update a separately written vector or full-text index. Coordinate those index writes in your application and use stable record IDs to connect results. See transaction guarantees and full-text indexing.

Link to this answer

Is OriginChainDB a distributed database?

Dedicated configurations can use a primary and optional standby with asynchronous replication. The primary accepts writes; promotion and availability depend on the configured topology. This is not a promise of quorum commit or multiple active writers. See replication and recovery behavior and your service agreement.

Link to this answer

Can vector search and SQL hit the same row?

Yes. Use the same stable ID for a SQL row and its vector entry, then fetch the row for a returned search ID. Supply vectors through the vector API, or use a saved embedder on a dedicated configuration. Configure an embedding schedule to process new and optionally changed rows; a row edit alone does not start an unscheduled job. See how vector entries relate to rows.

Link to this answer

How does natural-language /ask work?

Ask first tries a deterministic grammar against the schema catalog. If that cannot resolve the question, it uses the configured LLM; a compiled plan can then be cached. Pass a schema scope and use show_plan to inspect the result. Schema changes can invalidate cached plans. Read the Ask reference.

Link to this answer

Do I bring my own LLM key?

Ask can fall back to the LLM configured for the instance. Review the provider, credential handling and provider terms before enabling that path. The deterministic grammar and plan cache can answer supported requests without a new LLM call. See how Ask chooses its path.

Link to this answer

What does the AI compiler see?

An Ask question is sent to the configured LLM when the deterministic path needs that fallback. Do not include secrets or sensitive personal data in the question. Review the configured provider and data handling requirements rather than assuming every external inference call stays in the database region. Read the request guidance.

Link to this answer

Does OriginChainDB support graph queries?

Yes. Declare relations on registered tables, then follow connected records or use supported graph algorithms. Cypher and algorithm endpoints have different syntax, limits and result shapes; supported Cypher is a subset. Review traversal examples and limits.

Link to this answer

What languages does full-text search support?

The HTTP API uses Unicode tokenization and lowercase normalization across scripts. Engine stemmers and other analyzer stages are not all selectable through the API: do not assume stemming, lemmatization or accent folding is enabled. Check the live analyzer behavior and synonym support.

Link to this answer

Does OriginChainDB support transactions?

Single-row writes are atomic. The preview /tx API defaults to snapshot isolation with commit-time conflict detection and an optional serializable mode; SQL session transactions use read committed with different conflict behavior. Pick the surface for your workload and handle commit failures explicitly. Compare the two transaction APIs.

Link to this answer

Migration & embeddings

Copy source data, check rows and generate embeddings on dedicated configurations.

Which sources can I migrate, and does Migrate keep them in sync?

Migrate makes a one-time copy into a dedicated OriginChainDB instance. Supported sources include PostgreSQL and CockroachDB, MySQL and MariaDB, SQL Server, MongoDB, and S3-compatible object-storage files in CSV, TSV, JSONL or JSON-array format. Open your instance’s Platform area and select Data migration under Migrations. Review the proposed structure and mappings before approving the move. Continuous sync and SQLite file imports are not available. Watch the migration workflow overview on YouTube. Read the migration guide.

Link to this answer

Can I check a migration before copying rows?

Yes. Review the source analysis and destination mappings, then use Check data to find values that will not fit the plan before moving them. Check data does not write to the destination. Source access is read-only. Allowing masked samples helps detect column types; with samples off, analysis reads the structure only. Check data is also available after a failed or cancelled move.

Link to this answer

What does “rows set aside” mean after a migration?

By default, a one-time copy sets aside rows that cannot be moved and continues with the rest. You can instead choose Stop the table on the Source step. A table with set-aside rows is partial, not Verified. Inspect each recorded reason and fix the source values. Manual retry is available for supported PostgreSQL, CockroachDB, MySQL and SQL Server tables with usable primary keys; it adds missing rows without overwriting existing records. Retries are not automatic and are not available for MongoDB or file sources.

Link to this answer

Can I generate embeddings for a table already on my instance?

Yes, on dedicated configurations. Save and test an embedder in your organization’s Settings, under Embedders. Then open the instance’s Platform area and choose Embeddings. Select a table keyed by one column, the text columns in the order to combine them, optional row conditions and a maximum number of rows to embed. Runs use saved embedders and apply the initiating member’s row policies and column masks. Embedding a masked key or text column is refused. Read the embedding runs guide.

Link to this answer

Do embeddings update automatically when I change a row?

On dedicated configurations, set up an embedding schedule for new rows and optionally changed rows. Without a schedule, start an explicit run to refresh vectors. Runs that regenerate stored vectors also replace their metadata; other metadata under the same row ID is not retained. Review row limits in the embedding schedules guide.

Link to this answer

Where is my data sent when I use a saved embedder?

The selected text is sent to the saved embedder’s URL to generate vectors. Review that provider’s data handling and charges before running it, and set the required maximum row count. The current production workflow requires your own saved embedder; a managed OriginChainDB embedding service is not available. Do not include credentials in text columns selected for embedding.

Link to this answer

Performance

How to evaluate latency, throughput, recall and dataset size.

What latencies should I expect?

Latency depends on query shape, data size, indexes, hardware, load and network distance. Measure the full request path on your own dataset; a published benchmark is evidence for its stated setup, not a latency guarantee for every configuration. Review the benchmark methods and results.

Link to this answer

How fast is /ask?

A cache hit, a fresh grammar compilation and an LLM fallback have different costs. Inspect the cache field and query plan, then measure the path your application uses. There is no single response time that covers all three. See plan-cache behavior.

Link to this answer

How accurate and fast is vector search?

Vector accuracy and latency depend on the index, dimensions, metric, filters and search settings. Compare recall and tail latency together using a representative query set; fast and high_recall modes make different tradeoffs. Read published measurements and choose search settings.

Link to this answer

What throughput can I expect?

Use the configuration estimator for capacity planning, then benchmark your workload with representative concurrency, writes and queries. Sizing estimates are not measured throughput guarantees, and adding a standby does not imply linear query scaling. Review the benchmark resources.

Link to this answer

How many vectors can I store?

Capacity depends on vector dimensions, metadata, the index representation and available memory and storage. A documented index option does not establish measured performance at every corpus size. Review the index choices and discuss a representative capacity test.

Link to this answer

Operations

Backups, recovery, failover, observability and SDKs.

How are backups handled?

Dedicated configurations include a daily storage snapshot. Snapshot recovery and continuous archive are separate paths; the operations guide documents current archive limitations. Free and pooled configurations do not include point-in-time recovery. Review backups and recovery expectations.

Link to this answer

Do you support point-in-time recovery?

Continuous archive and restore-to-timestamp options for dedicated configurations are in preview. The operations guide records lagging or stalled archive progress, so do not treat sub-second or per-second recovery as delivered behavior. Plan against the available daily snapshot and review your recovery requirements with the team. Read the current recovery caveats.

Link to this answer

How does failover work?

A configured standby follows the primary asynchronously, so abrupt primary loss can lose recent acknowledged writes. Promotion is fenced by the writer lease; automatic promotion is opt-in and depends on the configured path and catch-up state. A standby does not replace a backup. Read the failover procedure and durability caveats.

Link to this answer

What observability do I get?

Health and readiness endpoints expose instance status; the usage endpoint reports per-tenant counts and activity. SQL EXPLAIN helps inspect query plans, and the operations guide describes tracing and monitoring options. Confirm the signals available on your deployed configuration. Explore operational monitoring.

Link to this answer

Which SDKs are available?

Python, TypeScript and Go clients cover different parts of the HTTP API. Python has the widest coverage; TypeScript also offers a control-plane client, while Go covers query surfaces. Use plain HTTP for operations your chosen SDK does not wrap. Compare the client coverage.

Link to this answer

Can I subscribe to live updates?

The HTTP reference documents a watch interface for change notifications. Check its supported subscription scope, delivery behavior and client handling before using it to keep another system in sync. Do not assume it is a durable replay log or a universal CDC replacement. Read the HTTP API reference.

Link to this answer

Security & compliance

Tenancy, encryption, audit logging, residency and certifications.

Is OriginChainDB single-tenant?

Dedicated configurations have their own compute and storage. Free and the $29 and $49 pooled configurations use shared infrastructure. Database isolation, network paths and access controls should be evaluated for the chosen deployment. Review the deployment boundaries.

Link to this answer

How is my data encrypted?

Managed public endpoints use HTTPS. The security page describes where TLS terminates and how the network path differs between shared and dedicated deployments. Review storage, backup and key-management requirements for your selected configuration. Read the security overview.

Link to this answer

Is there an audit log?

Review which identity, request and outcome fields your deployed service records, where you can access them, and the retention or export options in your agreement. Console preview screens alone do not establish live audit coverage. Review access and operational records.

Link to this answer

What about SOC 2, HIPAA, and GDPR?

Contact security@originchain.ai for current assessment status, questionnaires and contractual requirements. A database feature is not a compliance certification; evaluate the deployment and applicable agreement for your workload. Review the published security information.

Link to this answer

Where exactly does my data live?

Dedicated database resources are provisioned in the selected region. Account and billing are global services; external LLM providers and other integrations have their own data paths. Confirm database, backup and integration requirements together for your deployment. Read the deployment guide.

Link to this answer

Billing

What things cost, what is included, and how changes are charged.

How do add-ons work?

The dedicated estimator includes the four data models without separate model fees. Resource sizing, standby, recovery, networking and other agreed options affect the configuration. Confirm the available capabilities and final quote before launch. Review the configuration options.

Link to this answer

What happens if I upgrade or add an add-on mid-cycle?

Commercial timing follows the applicable agreement; the published Terms distinguish immediate upgrades from next-cycle downgrades. Do not assume all changes are available in place or have no interruption. Free, pooled and dedicated configurations currently do not support in-place switching between them. Review the Terms and discuss a change.

Link to this answer

Is there an annual discount?

Contact the team to agree a billing term or custom commitment. The public estimator shows a monthly equivalent and does not apply an automatic annual discount. Discuss commercial terms.

Link to this answer

What if I go over my configuration's quota?

The $29 configuration includes 25 GB storage and 20 GB monthly transfer; the $49 configuration includes 50 GB storage and 50 GB monthly transfer. Check current usage limits and billing terms in the console before purchasing. For other configurations, review included usage and the final agreement. See current allowances.

Link to this answer

What's included in Enterprise?

Enterprise is scoped around your deployment, network, region, recovery, support and contractual requirements. Confirm each capability and service commitment with the team rather than assuming a preset package or an unshipped topology. Discuss a custom deployment.

Link to this answer

Do vector, graph and full-text cost extra?

The dedicated pricing estimator includes SQL, vector, graph and full-text without separate per-model fees. Rows and indexes still consume compute, memory and storage, so workload size affects the estimate. Size a configuration.

Link to this answer

What is the Starter plan?

The current shared options are Configuration 25 GB pooled at $29/month with 20 GB monthly transfer, and Configuration 50 GB pooled at $49/month with 50 GB transfer. Both are monthly USD configurations with shared compute. Select a configuration in the console and review checkout before paying. See the current configuration names and limits.

Link to this answer

What does the cheapest dedicated configuration include?

The public estimator starts at $320/month for a Mumbai baseline with 2 vCPU, 8 GB RAM and 20 GB storage. This is a planning estimate in USD before applicable taxes; availability and the final quote are confirmed before launch. Review and adjust the estimate.

Link to this answer

What happens when I outgrow Starter?

Review a dedicated configuration when you need more capacity or dedicated resources. In-place switching from pooled to dedicated is not currently available; plan the data movement and application cutover with the team. Discuss the deployment path.

Link to this answer

Put the answers to work

Start with your own workload.

Explore the API, compare configurations, or talk through a deployment with the team.