Join us for live office hours! Next WednesdayNext Wed
12-Factor App
← Back to Glossary
Architecture

What is a 12-Factor App?

The 12-Factor App is a methodology for building modern, scalable, and maintainable software-as-a-service applications with best practices for deployment and operations.

The 12 Factors

  1. Codebase — one codebase tracked in version control, many deploys
  2. Dependencies — explicitly declare and isolate dependencies
  3. Config — store configuration in the environment, not in code
  4. Backing Services — treat databases, caches, and queues as attached resources
  5. Build, Release, Run — strictly separate build, release, and run stages
  6. Processes — execute the app as one or more stateless processes
  7. Port Binding — export services via port binding
  8. Concurrency — scale out via the process model
  9. Disposability — maximize robustness with fast startup and graceful shutdown
  10. Dev/Prod Parity — keep development, staging, and production as similar as possible
  11. Logs — treat logs as event streams
  12. Admin Processes — run admin and management tasks as one-off processes

Why It Matters

The 12-factor methodology was distilled from real-world experience deploying apps on platforms like Heroku. Its principles map directly to how cloud-native applications run today—in containers, on Kubernetes, and across managed services. Apps that follow these factors are easier to scale horizontally, deploy through CI/CD pipelines, and operate reliably in production.

In Practice

Most of these factors boil down to a few habits: externalize configuration, don't store state in the application process, and treat everything below your app as a replaceable resource. Teams that internalize these principles spend less time debugging environment-specific issues and more time shipping features.

Related Terms

Cloud NativeMicroservicesCI/CD

Related Articles

You Need More AWS Accounts Than You Think

Your lead engineer thinks 10 AWS accounts is overkill. Here's why starting clean is weeks of work, while untangling later is 6-12 months of migration pain.

Dec 19 2025

Building Enterprise-Grade Terraform: A Practical Guide

Ready to build enterprise-grade Terraform? This guide covers the architectural patterns, governance frameworks, and practical implementation steps that successful teams use to balance compliance with team autonomy.

Nov 15 2025

Why You Shouldn't Reinvent Your AWS Architecture

Why a battle-tested, opinionated reference architecture is a better starting point than building a custom AWS architecture from zero — and how successful teams avoid common traps.

May 15 2025

The 12-Factor Pattern Applied to Cloud Architecture

Apr 20 2016

The Production Ready Newsletter

Build Smarter. Avoid Mistakes. Stay Ahead of DevOps Trends That Matter.

The fastest way to achieve SOC 2 on AWS with Terraform and GitHub Actions.

For Developers

  • GitHub
  • Documentation
  • Quickstart Docs
  • Resources
  • Read our Blog

Community

  • Join Office Hours
  • Join the Slack Community
  • DevOps Podcast
  • Try our Newsletter

Company

  • Services & Support
  • AWS Migrations
  • Pricing
  • Book a Meeting

Legal

  • Terms of Use
  • Privacy Policy
  • Disclaimer
  • Cookie Policy
Copyright ©2026 Cloud Posse, LLC. All rights reserved.