
[[vertx:setup]]
== *vertx:setup*

This goal adds the Vert.x Maven Plugin to your `pom.xml` file. The plugin is configured with a default configuration.

=== Example

[source,subs="attributes"]
----
mvn io.fabric8:vertx-maven-plugin:{version}:setup
----

The setup goal by default uses the plugin property _vertx-core-version_
from the plugin properties file vertx-maven-plugin.properties as the vert.x version of the project,
if you wish to override the vertx version, then you can run the same command as above with `-DvertxVersion=<your-vertx-version>`

e.g.
[source,subs="attributes-with-version"]
----
mvn io.fabric8:vertx-maven-plugin:{version}:setup -DvertxVersion=3.4.0-SNAPSHOT
----

This will configure the vert.x and its dependencies to `3.4.0-SNAPSHOT` i.e. Maven project property `vertx.version`
set to `3.4.0-SNAPSHOT`



[[vertx:setup]]
== *vertx:setup*

This goal adds the Vert.x Maven Plugin to your `pom.xml` file. The plugin is configured with a default configuration.

=== Example

[source,subs="attributes"]
----
mvn io.fabric8:vertx-maven-plugin:{version}:setup
----

The setup goal by default uses the plugin property _vertx-core-version_
from the plugin properties file vertx-maven-plugin.properties as the vert.x version of the project,
if you wish to override the vertx version, then you can run the same command as above with `-DvertxVersion=<your-vertx-version>`

e.g.
[source,subs="attributes-with-version"]
----
mvn io.fabric8:vertx-maven-plugin:{version}:setup -DvertxVersion=3.4.0-SNAPSHOT
----

This will configure the vert.x and its dependencies to `3.4.0-SNAPSHOT` i.e. Maven project property `vertx.version`
set to `3.4.0-SNAPSHOT`

You can also generate a project if you don't have a `pom.xml` file:

[source,subs="attributes"]
----
mvn io.fabric8:vertx-maven-plugin:{version}:setup \
    -DprojectGroupId=org.acme \
    -DprojectArtifactId=acme-project \
    -DprojectVersion=1.0-SNAPSHOT \ # default to 1.0-SNAPSHOT
    -Dverticle=org.acme.Foo \
    -Ddependencies=web,jmx,mongo
----


The `verticle` parameter creates a new verticle class file.
The `dependencies` parameters specifies the Vert.x dependencies you need.

Extend documentaiton about the setup goal
Extend documentaiton about the setup goal
