# Configuration overview

Deploying Weaviate successfully depends on robust, well-considered configuration.
This section outlines key configuration requirements and best practices for production deployments.
Whether you are setting up a new environment or optimizing an existing one, configuration choices impact security, scalability, and reliability.

### Authorization and Authentication

::::card-grid
:::card{title="Authentication" href="/guides/authorization-and-authentication-deploy-configuration-authentication" icon="shield-half"}
Configure access management of your deployment.
:::

:::card{title="Authorization" href="/guides/authorization-and-authentication-deploy-configuration-authorization" icon="shield-user"}
Define and manage user roles and permissions.
:::

:::card{title="OIDC Configuration" href="/guides/authorization-and-authentication-deploy-configuration-oidc" icon="lock"}
Configure OpenID Connect for secure authentication with Weaviate.
:::

:::card{title="RBAC" href="/guides/authorization-and-authentication-weaviate-configuration-rbac" icon="users"}
Set up Role-Based Access Control for fine-grained permissions.
:::
::::

### Database configuration

::::card-grid
:::card{title="Environment variables" href="/guides/database-configuration-overview" icon="settings"}
Configure your environment variables for connection strings, ports, and security credentials.
:::

:::card{title="Runtime configuration" href="/guides/database-configuration-runtime-config" icon="sliders-horizontal"}
Manage runtime configuration settings for your Weaviate instance.
:::
::::

### Monitoring and Logging

::::card-grid
:::card{title="Monitoring and metrics" href="/guides/monitoring-and-logging-monitoring" icon="chart-bar"}
Collect Prometheus metrics to monitor the health and performance of your Weaviate instance.
:::

:::card{title="Logging" href="/guides/monitoring-and-logging-logging" icon="file-text"}
Configure log levels, formats, and audit logging for operational visibility and troubleshooting.
:::

:::card{title="Cluster status and metadata" href="/guides/monitoring-and-logging-status" icon="heart-pulse"}
Monitor cluster health, node data, and instance metadata.
:::

:::card{title="Telemetry" href="/guides/monitoring-and-logging-telemetry" icon="chart-line"}
Understand how Weaviate telemetry works and how to configure it.
:::
::::

### Replication and Scaling

::::card-grid
:::card{title="Replication" href="/guides/replication-and-scaling-replication" icon="copy"}
Set up data replication across nodes for high availability and fault tolerance.
:::

:::card{title="Asynchronous Replication" href="/guides/replication-and-scaling-async-rep" icon="copy"}
Ensure eventual consistency across nodes in a distributed cluster.
:::

:::card{title="Replica movement" href="/guides/replication-and-scaling-replica-movement" icon="move"}
Configure how replicas are moved between nodes during rebalancing.
:::

:::card{title="Horizontal scaling" href="/guides/replication-and-scaling-horizontal-scaling" icon="trending-up"}
Scale your deployment for high availability.
:::
::::

### Storage and Backups

::::card-grid
:::card{title="Backups" href="/guides/storage-and-backups-backups" icon="save"}
Configure backup and restore processes for your Weaviate instance.
:::

:::card{title="Collection export" href="/guides/storage-and-backups-export" icon="file-output"}
Export collections to cloud or local storage in Parquet format.
:::

:::card{title="Persistence" href="/guides/storage-and-backups-persistence" icon="save"}
Enable backups and configure retention policies.
:::

:::card{title="Tenant offloading" href="/guides/storage-and-backups-tenant-offloading" icon="pause-circle"}
Manage resource usage by offloading inactive tenants in multi-tenant setups.
:::
::::

## Questions and feedback

Have a question or feedback? Here's how to reach us.

::::card-grid
:::card{title="Community Forum" href="https://forum.weaviate.io/c/support" icon="messages-square"}
Ask questions and connect with other developers on our **Community forum**.
:::

:::card{title="Support" href="/guides/support-overview" icon="life-buoy"}
Weaviate Cloud user or customer? Find the right channel on the **Support page**.
:::
::::

## Related pages

- [Agents](./agents-index.md)
- [AI-assisted Weaviate code generation](./ai-assisted-vibe-coding-index.md)
- [APIs](./apis-index.md)
- [Authorization and authentication](./authorization-and-authentication-index.md)
- [Benchmarks](./benchmarks-index.md)
- [Best practices](./best-practices-index.md)
- [Client libraries](./clients-index.md)
- [Client Libraries / SDKs](./client-libraries-index.md)
- [Cloud](./cloud-index.md)
- [Cloud account management](./cloud-account-management-index.md)

# Agent Instructions

This portal answers questions programmatically. To receive a synthesized,
source-cited answer instead of crawling page by page, append the `?ask=`
query parameter to any page URL on this site:

    /guides/quickstart?ask=how+do+I+authenticate

Optional parameters:

- `&goal=<what-you-are-trying-to-do>` steers the answer toward your
  objective (e.g. `&goal=write+a+python+client`).
- `&version=<label>` scopes the answer to a mounted version when the
  portal publishes more than one.

The response is `text/markdown`: the answer followed by a `# Sources` list
of the portal pages it was grounded in. Status codes are the contract:

- `200` — the answer; `402` — the portal owner’s plan or answer credits are
  exhausted (surface this to your operator; do NOT retry); `429` — you are
  rate-limited; back off for the `Retry-After` seconds; `503` — the answer
  lane is temporarily unavailable; fall back to crawling the `.md` pages.

For the full corpus map read `llms.txt` at the site root; for the tool
surface (search + page fetch as MCP tools) see `/mcp`.