# Guides

- [V2 to V3 Migration Guide](/guides/migration-v2-to-v3.md): Complete migration guide from Elsa Workflows V2 to V3, covering breaking changes, custom activities, workflows, and concepts.
- [Architecture](/guides/architecture.md): High-level overview of Elsa Workflows v3 architecture, covering workflow execution flow, core concepts like bookmarks and triggers, workflow runtimes, and multitenancy.
- [Workflow Dispatcher Architecture](/guides/architecture/workflow-dispatcher.md): Deep dive into IWorkflowDispatcher: the core dispatching abstraction for queuing and executing workflows, covering request types, event ordering, and custom dispatcher implementations.
- [Onboarding](/guides/onboarding.md)
- [Hosting Elsa in an Existing App](/guides/onboarding/hosting-elsa-in-existing-app.md): Step-by-step guide to integrating Elsa Workflows into an existing ASP.NET Core application, including persistence setup, common pain points, and troubleshooting.
- [Authentication & Authorization](/guides/authentication.md): Comprehensive guide to configuring authentication and authorization for Elsa Workflows, covering OIDC providers, API keys, custom authentication, and security best practices.
- [Security & Authentication](/guides/security.md): Comprehensive guide to securing Elsa Server and workflows end-to-end, covering identity, authentication, tokenized resume URLs, CORS, secrets management, and production hardening.
- [Disable Auth in Development](/guides/security/disable-auth.md): Guide for disabling authentication in Elsa Server and Studio during development to simplify local testing and experimentation.
- [External Identity Providers](/guides/security/external-identity-providers.md): Guide to integrating Elsa Server with external identity providers including Microsoft Entra ID, Auth0, Keycloak, and other OpenID Connect / OAuth2 providers.
- [Deployment](/guides/deployment.md)
- [Kubernetes Basics](/guides/deployment/kubernetes.md): Quick start guide for deploying Elsa Workflows to Kubernetes with PostgreSQL persistence, including configuration, troubleshooting, and production best practices.
- [Kubernetes Deployment](/guides/kubernetes-deployment.md): Complete Kubernetes deployment guide for Elsa Workflows including Helm charts, deployment configurations, ingress setup, autoscaling, monitoring, service mesh integration, and production best practice
- [Integration](/guides/integration.md)
- [Blazor Dashboard](/guides/integration/blazor-dashboard.md): Guide to integrating Elsa Studio with Blazor Server applications, covering hosting patterns, authentication configuration, and troubleshooting common issues.
- [Clustering](/guides/clustering.md): Comprehensive guide to running Elsa Workflows in clustered and distributed production environments, covering architecture patterns, distributed locking, scheduling, and operational best practices.
- [Performance & Scaling](/guides/performance.md): Comprehensive guide to optimizing Elsa Workflows for high-throughput scenarios, covering commit strategies, state persistence tuning, observability, and performance best practices.
- [Throughput Tuning](/guides/performance/throughput-tuning.md): Practical examples for tuning Elsa Workflows throughput, including commit strategies, clustering optimizations, and resource management.
- [API & Client](/guides/api-client.md): Comprehensive guide to interacting with Elsa Server programmatically via HTTP APIs and the elsa-api-client library, covering workflow publishing, instance management, bookmarks, and resilience pattern
- [Persistence](/guides/persistence.md): Comprehensive guide to choosing, configuring, and tuning persistence providers for Elsa Workflows v3, covering EF Core, MongoDB, and Dapper, along with retention, migrations, and operational best prac
- [SQL Server](/guides/persistence/sql-server.md): Complete guide to configuring SQL Server as the persistence provider for Elsa Workflows v3, including setup, configuration, and migration guidance.
- [EF Core Migrations](/guides/persistence/ef-migrations.md): Complete guide to working with Entity Framework Core migrations in Elsa Workflows v3, including custom migrations, DbContext management, and versioning strategies.
- [EF Core Setup](/guides/persistence/efcore-setup.md): Minimal example to enable Entity Framework Core persistence for Elsa Workflows, including database provider setup and migrations.
- [MongoDB Setup](/guides/persistence/mongodb-setup.md): Minimal example to enable MongoDB persistence for Elsa Workflows, including connection configuration and index creation guidance.
- [Dapper Setup](/guides/persistence/dapper-setup.md): Minimal example to enable Dapper persistence for Elsa Workflows, including connection factory setup and schema responsibility notes.
- [Indexing Notes](/guides/persistence/indexing-notes.md): Recommended database indexes for Elsa Workflows persistence stores to optimize common query patterns.
- [HTTP Workflows](/guides/http-workflows.md)
- [Tutorial](/guides/http-workflows/tutorial.md)
- [Programmatic](/guides/http-workflows/programmatic.md)
- [Designer](/guides/http-workflows/designer.md)
- [External Application Interaction](/guides/external-application-interaction.md)
- [Loading Workflows from JSON](/guides/loading-workflows-from-json.md)
- [Plugins & Modules](/guides/plugins-modules.md): Complete guide to extending Elsa Workflows with custom modules, features, and activities. Learn how to create reusable plugins and distribute them as NuGet packages.
- [Extensibility](/guides/modules-and-plugins.md): Learn how to extend Elsa Workflows v3 with custom modules and plugins. Covers module registration, contributing activities, services, and API endpoints with practical examples.
- [Testing & Debugging Workflows](/guides/testing-debugging.md): Comprehensive guide to testing and debugging workflows in Elsa Workflows, covering unit testing, integration testing, debugging techniques, test data management, CI/CD integration, and best practices.
- [Running Workflows](/guides/running-workflows.md)
- [Using Elsa Studio](/guides/running-workflows/using-elsa-studio.md)
- [Using a Trigger](/guides/running-workflows/using-a-trigger.md)
- [Dispatch Workflow Activity](/guides/running-workflows/dispatch-workflow-activity.md)
- [Studio User Guide](/guides/studio.md): A comprehensive guide to using Elsa Studio, the visual designer and admin UI for Elsa Workflows v3.
- [Expressions](/guides/studio/expressions.md): Learn how to use expressions in Elsa Studio to reference variables, access data, and create dynamic workflows with JavaScript and C# code.
- [Custom UI Components](/guides/studio/custom-ui-components.md): Learn how to create custom UI components for Elsa Studio, including custom property editors for activity inputs and integration of React/Angular components via web components.
- [Integration](/guides/studio/integration.md): Comprehensive guide to integrating Elsa Studio into different host frameworks including React, Angular, Blazor, and MVC/Razor Pages. Covers hosting patterns, configuration, and authentication.
- [Workflow Patterns](/guides/patterns.md): A practical, pattern-based guide to designing and implementing common workflow patterns with Elsa Workflows v3. Each pattern provides grounded guidance, code snippets, pitfalls, and references to elsa
- [Troubleshooting](/guides/troubleshooting.md): Comprehensive troubleshooting guide for diagnosing and resolving common Elsa Workflows issues in development and production environments.