Vertx - Distribution Deployment

Java Conceptuel Diagram


Distribution deployment is the deployment of a verticle that is based on the availability of a vertx distribution


Example with gradle and the java library distribution

plugins {
  id 'java'
  id 'java-library-distribution'
dependencies {

  // Vert.x
  compileOnly  "io.vertx:vertx-core:$vertxVersion"
  // Web
  compileOnly  "io.vertx:vertx-web:$vertxVersion"
  compileOnly  "io.vertx:vertx-web-client:$vertxVersion"
  // Database
  compileOnly  "io.vertx:vertx-jdbc-client:$vertxVersion"
  api "org.hsqldb:hsqldb:2.5.0"
  // Vertx service
  compileOnly  "io.vertx:vertx-service-proxy:$vertxVersion"
  compileOnly  "io.vertx:vertx-codegen:$vertxVersion"
  annotationProcessor "io.vertx:vertx-codegen:$vertxVersion:processor"
  // <3.8.4
  // annotationProcessor "io.vertx:vertx-service-proxy:$vertxVersion:processor"
  compileOnly "io.vertx:vertx-service-proxy:$vertxVersion"
  annotationProcessor "io.vertx:vertx-service-proxy:$vertxVersion"
  • By running the distZip tasks, You get the verticle and its runtime dependencies in a zip format. Example unzipped:

Vertx Verticle And Lib

  • Copy the zip to your server
  • Unzip it into a directory (generally /verticles)


cd /verticles # the location of the verticle jar
vertx run
    -cp /verticles/MY_VERTICLE.jar;/verticles/lib/*
cd /verticles
docker run -i -t -p 8080:8080 \ 
    -v $PWD:/verticles \
    vertx/vertx3-exec \  
    run \ 
    -cp /verticles/MY_VERTICLE.jar;/verticles/lib/*

Discover More
Java Conceptuel Diagram
Vert.x - Deployment

in Vert.x You have two ways to deploy your Vert.x application. You can provide: a fat jar that contains all dependency on only the verticle when you have already a vert.x distribution. main class...

Share this page:
Follow us:
Task Runner