Download
The AxonIQ Initializr is a web application that creates an Axon project structure for you. It doesn’t generate any application code, but it will give you a solid project structure, offering either a Maven or a Gradle build specification to suit your needs. Once you’ve downloaded your generated project, all that remains is to unzip, open, and begin work on your Axon code.
All Axon Framework-related JAR files are published on Maven Central.
Spring Boot applications
To use Axon Framework in a Spring Boot application build with Maven add
<dependency>
<groupId>org.axonframework</groupId>
<artifactId>axon-spring-boot-starter</artifactId>
<version>${axon.version}</version>
</dependency>
to your POM.
Plain Java applications
To use Axon Framework in a plain Java application build with Maven add
<dependency>
<groupId>org.axonframework</groupId>
<artifactId>axon-configuration</artifactId>
<version>${axon.version}</version>
</dependency>
to your POM.
For usage with Maven, import the BOM in your project like so:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.axonframework</groupId>
<artifactId>axon-bom</artifactId>
<version>${version.axon}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
...
</dependencies>
</dependencyManagement>Then add the dependencies you need without specifying the version:
...
<dependencies>
<dependency>
<groupId>org.axonframework</groupId>
<artifactId>axon-configuration</artifactId>
</dependency>
<dependency>
<groupId>org.axonframework</groupId>
<artifactId>axon-server-connector</artifactId>
</dependency>
<dependency>
<groupId>org.axonframework.extensions.kafka</groupId>
<artifactId>axon-kafka</artifactId>
</dependency>
<dependency>
<groupId>org.axonframework.extensions.mongo</groupId>
<artifactId>axon-mongo</artifactId>
</dependency>
...
</dependencies>
...For usage with Gradle Version 4.x and below, apply the dependency-management-plugin like so:
buildscript {
repositories {
jcenter()
}
dependencies {
classpath "io.spring.gradle:dependency-management-plugin:0.5.1.RELEASE"
}
}
apply plugin: "io.spring.dependency-management"After this, import the Axon BOM:
dependencyManagement {
imports {
mavenBom 'org.axonframework:axon-bom:<VERSION>'
}
}Beginning with Gradle version 5.0, you can also omit the dependency-management plugin and instead use the platform dependency dsl to import maven boms:
implementation(platform("org.axonframework:axon-bom:<VERSION>"))
You can download a ZIP file with Axon Server as a standalone JAR. This will also give you the Axon Server CLI and information on how to run and configure the server.
Looking for a previous version of the JAR file?
Run the following command to start Axon Server in a Docker container:
docker run -d \ --name axonserver \ -p 8024:8024 \ -p 8124:8124 \ axoniq/axonserver:<TAG>
Visit Axon Server on Docker Hub for the list of available tags and their meaning.
Run the following command to start Axon Server Enterprise in a Docker container:
docker run -d \ --name axonserver \ -p 8024:8024 \ -p 8124:8124 \ axoniq/axonserver-enterprise:<TAG>
Visit Axon Server Enterprise on Docker Hub for the list of available tags and their meaning.
Looking for a previous version?
To activate Axon Server Enterprise, you need to obtain a license key
The Axon Quickstart zip includes everything that you need to get started with Axon Stack
Axon Framework
Open-source framework for event-driven microservices and domain-driven design.
Axon Server
A Zero-configuration message router and event store, ready to run locally.
Gift Card Sample Application
An easy way to understand Axon application, complete with sources.
Getting Started Guide
In the README.md file, you will find a complete guide to getting up and running with Axon and links to some other resources that you may find interesting.
