Home

Welcome to Lagom

  1. What is Lagom?
  2. What’s in the name?
  3. Where to begin

Getting started with Lagom

  1. Introduction
  2. Lagom Java prerequisites
  3. Creating and running Hello World with Maven
  4. Creating and running Hello World with sbt
  5. Understanding Hello World
  6. Lagom examples
  7. What's Next?

Lagom core concepts

  1. Introduction to Lagom concepts
  2. Lagom design philosophy
  3. Polyglot systems with Lagom
  4. Development environment overview
  5. Lagom build philosophy
  6. Component technologies
  7. API Overview
  8. Designing your microservices system
  9. Sizing individual microservices
  10. Internal and external communication
  11. Registering and discovering services
  12. Using Immutable Objects
  13. Managing data persistence
  14. Advantages of Event Sourcing
  15. Separating reads from writes
  16. Deploying scalable, resilient systems

Lagom reference guide

  1. Reference Guide
  2. Configuring builds and the development environment
    1. Defining a Lagom build
    2. Splitting a system into multiple builds
    3. Importing an existing Maven project into Eclipse
    4. Creating a new Maven Eclipse project with the Lagom archetype
    5. Importing an sbt project into Eclipse
    6. Importing an existing Maven Project into Intellij
    7. Importing an sbt project into Intellij
    8. Set up Immutables in your IDE
    9. Increase memory for sbt and Maven
    10. Using a newer version of Akka and Play Framework
  3. Running Lagom in development
    1. Development Environment
    2. Running Services
    3. How are Lagom services configured in development?
    4. Service Locator and Service Gateway
    5. Cassandra Server
    6. Kafka Server
  4. Writing Lagom services
    1. Service descriptors
    2. Implementing services
    3. Service Metadata
    4. Consuming services
    5. Testing Services
    6. Message serializers
    7. Header Filters
    8. Error handling
    9. Additional Routers
  5. Writing persistent and clustered services
    1. Domain Modelling with Akka Persistence Typed
    2. Migrating to Akka Persistence Typed
    3. Persistent Entity (classic)
    4. Choosing a Database
    5. Cassandra Setup
    6. Relational Database Setup
    7. Persistent Read-Side
    8. Cassandra Read-Side Support
    9. Relational Database Read-Side Support
    10. JDBC Read-Side Support
    11. JPA Read-Side Support
    12. Publish-Subscribe
    13. Cluster
    14. Serialization
    15. Projections
  6. Decouple services with a message broker
    1. Message Broker Support
    2. Message Broker API
    3. Lagom Kafka Client
    4. Message Broker Testing
  7. Running Lagom in production
    1. Production Overview
    2. Akka Discovery Integration
    3. Lightbend Platform
  8. Logging
    1. Logging
    2. Configuring Logging
  9. Advanced topics
    1. Integrating with Akka
    2. Integrating with non Lagom services

Lagom releases

  1. What's new in Lagom 1.6
  2. What's new in Lagom 1.5
  3. Lagom 1.6 Migration Guide
  4. Lagom 1.5 Migration Guide
  5. Lagom 1.4 Migration Guide
  6. Lagom 1.3 Migration Guide
  7. Lagom 1.2 Migration Guide

Found an error in this documentation? The source code for this page can be found here. Please feel free to edit and contribute a pull request.