Choose a path
Responsibility at a glance
For the demo and self-host paths, the core Compose stack runs the web app,
migrations, PostgreSQL, and Valkey. Manual checks run without Temporal on every
path. Scheduled checks require the worker plus Temporal; see
manual and scheduled checks.
Hosted beta
The hosted beta operates the application infrastructure, PostgreSQL, Valkey, Temporal scheduling, and platform backups. You sign in to a managed instance and connect your own data providers. Provider usage is not included by bisibility. You connect your own SERP provider credentials, and provider billing stays directly between you and the provider. See Integrations for the supported providers, credentials, and the per-project budget cap. See current hosted beta limits below.Local seeded demo
The local seeded demo is a disposable evaluation. It boots from seeded synthetic data and uses an intentionally insecure fixed sign-in code, so anyone who reaches the app can sign in. It is not a production base. The demo ships with no SERP provider, so it produces no real rank data until you connect one. It is meant to be stopped and discarded. Start it with the Quickstart or the local Compose demo, and never expose it on a public address.Production self-host
A production self-host operator owns PostgreSQL, Valkey, application secrets, backups and restore testing, upgrades, provider credentials, provider usage, and infrastructure costs. The worker plus Temporal are required only for scheduled work, not for manual checks. Start from the Self-hosting operator landing page. It lists the required components, the canonical Compose family, the production topology, and the production checklist. For the full environment variable reference, see self-hosting configuration.Current hosted beta limits
This page is the canonical public source for current hosted beta resource limits.- 1,000 keywords per project
- 3 owned projects per user
Self-hosted resource limits
Self-hosted deployments can set optional resource limits through two environment variables:BISIBILITY_MAX_KEYWORDS_PER_PROJECT- per-project keyword capBISIBILITY_MAX_PROJECTS_PER_USER- cap on projects one user may own
0 means unlimited for both. The hosted beta values above do not
apply to self-hosted installations. See
self-hosting configuration
for the full variable reference.
Provider usage and billing
bisibility ships without a data source. Any real provider-backed check uses SERP provider credentials you connect, and provider billing is directly between you and the provider. bisibility does not resell or include provider usage. You set a per-project monthly budget cap in Settings > Provider usage so spend has a ceiling. See Budget cap. A fresh demo with no provider connected incurs no provider cost and produces no real rank data.Manual and scheduled checks
Manual checks run inline in the app or throughPOST /api/v1/keywords/{id}/checks without Temporal. For the local demo and
self-hosted deployments, the core Compose stack - web app, migrations,
PostgreSQL, and Valkey - supports manual checks without the worker or Temporal.
Scheduled checks are executed by the Temporal worker. To enable them on a
self-hosted or demo Compose stack, add the worker and Temporal overlays:
From demo to production
Moving from the demo to production means starting a fresh production deployment with production secrets, authentication, storage, backups, and provider credentials. Do not promote or harden the disposable demo in place: its fixed sign-in code, seeded synthetic data, and generated secrets are not safe to keep serving. Start a new production Compose stack from the immutable release assets in an empty directory, then complete the production checklist before the instance serves anyone other than you. Keep the web app and worker pinned to the same release, and follow upgrade with a distribution manifest for every later version.Next steps
- Quickstart - run the local demo and first manual check.
- Self-hosting - required components, topology, and checklist.
- API quickstart - authenticate and make one verified REST request.
- Integrations - connect a SERP provider and set the budget cap.
- Temporal and scheduled checks - enable scheduled work.