# Layero documentation map

Every page is also available as Markdown — the same address with `.md` appended.


- [What is Layero](https://docs.layero.ru/en/): Layero builds and publishes sites and apps on servers in Russia — from a repository, from a folder or by an AI agent. Custom domains, branch previews, server apps, Postgres databases.
- [Contact](https://docs.layero.ru/en/contacts/): How to reach the Layero team — the support chat in the dashboard, support@layero.ru, a Telegram bot and GitHub. Response times follow the support terms.
- [Support](https://docs.layero.ru/en/support/)

## Getting started

- [How it all fits together](https://docs.layero.ru/en/getting-started/concepts/): Organization, project, environment, build and main address — what Layero is made of and how the parts connect. Static sites and apps with a server, the "Made with Layero" label.
- [Your first site](https://docs.layero.ru/en/getting-started/quickstart/): Publish a site from a folder with one command — no repository. Sign in with an emailed code or Yandex ID, the build runs on Layero, the address works as soon as the build ends.

## AI agents

- [How an AI agent works with Layero](https://docs.layero.ru/en/agents/): An agent publishes and runs the site itself — through a connected repository, the CLI or MCP. The three paths, one-click sign-in, a site without an account, what an agent never does.
- [Agent reports on the docs](https://docs.layero.ru/en/agents/feedback/): How an AI agent tells Layero about a mistake in the docs, what goes into a report and what never does.
- [Connect an agent](https://docs.layero.ru/en/agents/install/): Install commands for the Layero skill and MCP server in Claude Code, Cursor, Codex and any agent. Browser sign-in, the LAYERO_TOKEN token for CI and the Claude Code plugin, checking the connection.
- [MCP tools](https://docs.layero.ru/en/agents/mcp-tools/): Every tool of the mcp.layero.ru server by group — which ones change the site and need a person's consent, what works without signing in, how to limit a connection to one project or to read-only.
- [The layero skill](https://docs.layero.ru/en/agents/skill/): What is in the LayeroInfra/layero-agents skill, how to install it and what npx layero@latest init adds to the project's AGENTS.md.
- [CLI JSON events](https://docs.layero.ru/en/cli/json-events/): The full list of events and error codes the Layero CLI emits on stdout in JSON mode. The canonical reference for AI agents and CI.

## Build

- [Environment variables](https://docs.layero.ru/en/deploys/env-vars/): How to set a project's environment variables in the dashboard, with the CLI and the API, when they take effect, which variables the platform sets and what the limits are.
- [layero.json — configuration in the repository](https://docs.layero.ru/en/deploys/layero-json/): A file in the repository sets the framework, the build and start commands, the output folder, the Node version, the app type and the frontend + backend layout. When you need it, the complete key list, a symptom-to-fix table and how to verify in the build log.
- [Node.js and Python versions](https://docs.layero.ru/en/deploys/runtime-versions/): Which Node.js and Python versions Layero supports, which one is the default, how to pin your own and what happens if you set an unsupported one.
- [Frameworks](https://docs.layero.ru/en/getting-started/frameworks/): Which frameworks Layero detects by itself and where it takes the build output from, how it tells a static site from an app with a server, which package manager it uses and how to set the framework by hand.

## Deploys

- [From a folder with the CLI](https://docs.layero.ru/en/cli/deploy/): How to publish a folder with layero deploy — no repository. What happens on upload, where it lands, flags, what isn't sent, build limits and JSON mode.
- [From GitHub Actions](https://docs.layero.ru/en/cli/github-actions/): The official GitHub Action for deploying to Layero — CI tokens, building in your pipeline, pull-request previews, step outputs and the errors you are likely to hit.
- [Rollback and picking a build](https://docs.layero.ru/en/cli/rollback/): How to bring back the previous build on the main address or publish any ready build — with dashboard buttons and the layero rollback and layero promote commands.
- [Environments and previews](https://docs.layero.ru/en/deploys/environments/): The project's main address and branch previews, how a build becomes the main one, how many previews run at once, rollback and the «Сайт скоро появится» page.
- [Connecting a repository](https://docs.layero.ru/en/deploys/git-providers/): How to connect a repository on GitHub, GitVerse, GitLab, GitFlic or SourceCraft, how the providers differ and what happens after a push.
- [GitHub](https://docs.layero.ru/en/deploys/github/): How to connect a GitHub repository through the GitHub App, what happens after a push to the main branch and to other branches, and how to publish by hand.
- [GitVerse](https://docs.layero.ru/en/deploys/gitverse/): How to issue a token in GitVerse, connect it to a Layero organization and import a repository. How GitVerse differs from GitHub.
- [Build retention](https://docs.layero.ru/en/deploys/retention/): How many ready builds Layero keeps for rollback, what happens to old branches, how to go back to an old version and how to download the sources of an upload.

## Addresses

- [Custom domain](https://docs.layero.ru/en/deploys/custom-domains/): How to connect your own domain to a project on Pro — which DNS records to add, how Layero issues the certificate, what to do with your previous hosting's records and what happens to the domain if Pro ends.
- [HTTP headers](https://docs.layero.ru/en/deploys/custom-headers/): How to add your own HTTP headers to a static site with a _headers file — syntax, supported paths, headers you can't set and how to check the result.
- [The 404 page and redirects](https://docs.layero.ru/en/deploys/not-found-404/): What Layero answers for an address that isn't in the build, how clean URLs and SPAs work, how to set your own 404 page and redirects in a _redirects file.

## Apps with a server

- [Running and idling](https://docs.layero.ru/en/runtime/lifecycle/): How an app with a server freezes, goes to sleep and wakes up on the first request, what that means for your code, what resources the plan gives and which time is paid for.
- [When you need an app with a server](https://docs.layero.ru/en/runtime/overview/): Next.js with server rendering, Node.js servers (Express, NestJS, Fastify) and Python servers (Django, FastAPI, Flask), Streamlit and Gradio — the app types, how to set the type and what the app needs.
- [Files and state](https://docs.layero.ru/en/runtime/stateless/): An app with a server has a temporary disk. What doesn't work because of that — writes to SQLite, file sessions, uploads to disk — and where to keep data, files and sessions.

## Databases (beta)

- [Databases](https://docs.layero.ru/en/database/): Managed PostgreSQL in Layero — a shared database in the Pro plan and a dedicated database with its own configuration. How they differ, what the section can do and where to start.
- [Backups](https://docs.layero.ru/en/database/backups/): Layero database backups — schedule and retention for a shared database, a paid option for a dedicated one, one-click restore, and downloading a PostgreSQL dump.
- [Databases from the CLI](https://docs.layero.ru/en/database/cli/): The layero db commands — listing databases, creating one, connecting and disconnecting a project, running SQL from the terminal and in CI. What can't be done from the terminal and why.
- [Connecting to a database](https://docs.layero.ru/en/database/connect/): Layero database connection string, network access modes, and server certificate verification (verify-full) for psql, asyncpg, node-pg, Prisma, and Drizzle.
- [Creating a database](https://docs.layero.ru/en/database/create/): Creating a Layero database from the dashboard and the CLI — a shared database from the Pro plan or a dedicated one with its own configuration, the PostgreSQL version, payment, how long it takes and what to do if it fails.
- [Limits](https://docs.layero.ru/en/database/limits/): Layero database limits — how many databases, storage and what happens when it runs out, connections and the pool, query time, the SQL editor and layero db sql, backups, address-based access.
- [Working in the dashboard](https://docs.layero.ru/en/database/panel/): What's on a Layero database page — overview, monitoring, tables, SQL editor, functions, triggers, roles, RLS policies, extensions, settings, connected projects, renaming and deletion.
- [Pricing](https://docs.layero.ru/en/database/pricing/): How much Layero databases cost — a shared database in the Pro plan, prices for a dedicated database and a custom configuration, hourly charges from the balance, changing the configuration, deletion, and what happens if the balance runs short.

## Data API (beta)

- [What Data API Is](https://docs.layero.ru/en/data-api/): The HTTP layer over your Layero project database — tables, functions, user sign-in, files. Compatible with Supabase clients.
- [User Sign-In](https://docs.layero.ru/en/data-api/auth/): Sign-up and sign-in for an application on Data API, the authenticated role, auth.uid() in policies, and exchanging a panel session for a database session.
- [Example: Layero Inbox](https://docs.layero.ru/en/data-api/example-inbox/): An app with a database and no backend: Postgres, Data API, auth, private files and Telegram notifications — step by step, in the dashboard and the CLI.
- [What's Missing](https://docs.layero.ru/en/data-api/limits/): What's not supported in Data API and where the boundaries are.
- [Sign-in with Yandex, VK ID and Sber ID](https://docs.layero.ru/en/data-api/oauth/): How to connect sign-in through an external provider — the provider's side, the callback URL, scopes, the button on your site and what happens to the account.
- [Accepting Requests from Another Domain](https://docs.layero.ru/en/data-api/origins/): How to let a client's site send data to your database without handing it access to the database.
- [HTTP from SQL](https://docs.layero.ru/en/data-api/outbound/): Telegram notifications and webhooks straight from a database function — net.http_post, like pg_net in Supabase.
- [Migration Pitfalls](https://docs.layero.ru/en/data-api/pitfalls/): Six spots where people most often trip up when moving a project from Supabase or writing their first Data API application.
- [Tables and REST](https://docs.layero.ru/en/data-api/rest/): Reading and writing tables over HTTP, PostgREST filters, granting a role access, and RLS policies.
- [Functions and RPC](https://docs.layero.ru/en/data-api/rpc/): Calling database functions over HTTP. The api schema is the only public storefront; argument names are a public contract.
- [Files](https://docs.layero.ru/en/data-api/storage/): The database's file storage — buckets, policies on storage.objects, signed URLs and limits. Compatible with supabase.storage.

## Speed and analytics

- [Page Speed](https://docs.layero.ru/en/performance/): Page Speed in Layero measures page load speed in a real browser. What we measure, under which conditions, how to read the report and the "got worse" verdict, schedules, Telegram notifications, CLI and plan.
- [How we measure speed](https://docs.layero.ru/en/performance/methodology/): How the Layero performance audit works — where and how the page is opened, which metrics we collect, how the Lighthouse score is calculated, how runs are compared and why the numbers differ from PageSpeed Insights.
- [Analytics and Russian data law (152-FZ)](https://docs.layero.ru/en/team/analytics/): Who is responsible for visitor data when Yandex Metrica or the Google Sheets form export is connected, why you need a cookie banner, what session recording (Webvisor) does and how to turn it on or off.

## CLI reference

- [All commands](https://docs.layero.ru/en/cli/commands/): Reference of Layero CLI commands — publishing, projects and environments, rollback, logs and diagnostics, variables, domains, databases and the Data API, analytics, speed, hooks, tokens. Common flags and CLI environment variables.
- [Installing and signing in](https://docs.layero.ru/en/cli/install/): How to run the Layero CLI with npx layero@latest, sign in through the browser with an emailed code or Yandex ID, where the sign-in is stored and which token CI needs.

## Teams & integrations

- [The GitHub App integration](https://docs.layero.ru/en/team/github-app/): Why the GitHub App exists, how to install it on a personal account or an organization, how it differs from OAuth, and how to disconnect it.
- [Organizations (personal and team)](https://docs.layero.ru/en/team/organizations/): How a personal account differs from a team, when to use which, and how to switch between them.

## Plans & billing

- [Balance and renewal](https://docs.layero.ru/en/billing/lifecycle/): How to top up an organization's balance and set up auto top-up, how the subscription renews, what happens after the trial, the grace period, what is suspended after moving to Free and how it all comes back. Deleting your account and money on the balance.
- [Extra usage](https://docs.layero.ru/en/billing/overage/): How to keep working above the plan limits on Pro: how to turn it on and set a budget, how and when we charge the balance, and what happens when the budget runs out or the balance is empty.
- [Free and Pro plans](https://docs.layero.ru/en/billing/plans/): How Free and Pro differ — projects, builds, custom domains, search indexing, apps with a server, the shared database, seats for colleagues. Prices, the trial and switching between plans.
- [Usage and limits](https://docs.layero.ru/en/billing/usage/): What the Usage page counts, the Free and Pro limits and when they take effect, how the billing period works, and what happens when a limit runs out.
