> ## Documentation Index
> Fetch the complete documentation index at: https://context7-enes-docs7-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Deployments

> How builds run, what the log shows, and how to troubleshoot failures

Every push to a connected branch creates a deployment: Docs7 clones the repository, builds the site in an isolated sandbox, and publishes the result to the edge. You can also trigger a production deployment manually from [the dashboard](/docs7/dashboard).

## Lifecycle

A deployment moves through `queued → running → ready` (or `failed`). The dashboard shows the build log live: clone, build (with the builder's own output streamed in), and publish, with timings per phase.

* **A failed update never takes the site down.** The previous build keeps serving until a new build succeeds.
* **One build per target at a time.** Pushes to the same branch queue up; if a newer push arrives before an older one starts, the older deployment ends as *"Superseded by a newer deployment"*.
* **Automatic retries.** Deployments interrupted by infrastructure (not by your content) are retried automatically. A deployment that cannot complete within 45 minutes is marked failed.
* **History.** The last 50 deployments per site are kept, with logs retained for 7 days.

## GitHub feedback

Each deployment posts a `docs7/production` or `docs7/preview` commit status on the exact commit it built, and preview deployments upsert a single comment on each open pull request for that branch with the preview link. Manual dashboard deployments have no commit, so they post no status.

## Understanding build failures

The failure reason is always in the build log. Common ones:

| Message                                                                         | Cause and fix                                                                                                                                                        |
| ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `The docs path does not contain docs.json or mint.json`                         | Wrong docs path in the site settings, or the config file is missing.                                                                                                 |
| `N documentation pages failed to build`                                         | The log lists each failing page and its error, usually invalid MDX or a missing snippet. Fix the pages and push. Files outside the navigation only produce warnings. |
| `The build timed out after 900 seconds`                                         | The build exceeded your plan's [build timeout](/docs7/limits): 15 minutes on Free, 30 on Pro.                                                                        |
| `The repository contains more than 100000 files` / `larger than the 1 GB limit` | The docs source tree exceeds the [source limits](/docs7/limits).                                                                                                     |
| `The repository contains a symbolic link outside the repository`                | A symlink points outside the clone (or is broken / targets a directory). Symlinks to files inside the repository are fine; they're materialized automatically.       |
| `Superseded by a newer deployment`                                              | Nothing to fix. A newer push replaced this one.                                                                                                                      |

Two things that do **not** fail a build: search indexing problems (the site publishes without search, with a warning) and individual files over the 25 MB asset limit (they're skipped and listed at the end of the log).

<Note>
  The build sandbox has no network access. Anything your docs try to fetch at build time, like remote OpenAPI specs or images, will not resolve. Commit those files to the repository.
</Note>