Application Deployment MSBuild tasks

Official Content
This documentation is valid for:

The  Application Deployment tool is based on MSBuild tasks, which allow you to easily extend and/or customize your deployments. Using those tasks, you can automate deployment.

The following document lists those tasks and details how to use them in order to either extend what GeneXus does or automate your deployments.


The CreateDeployProject task will analyze what GeneXus objects must be included in the deployment based on the call tree of every selected object (or every main object if none). The output of this task is an MSBuild script with the extension .gxdproj that will hold every environment property and object (with its properties) needed for a successful deployment.

GeneXus provides a script called Deploy.msbuild which is used by GeneXus itself and it's a great starting point for automating your calls. Use the following command to create a deployment project of every main in your Knowledge Base.

msbuild.exe deploy.msbuild /p:KBPath=<Path to your Knowledge Base>

This will create the deploy project file for the trunk version of the mentioned Knowledge Base for every main object in that version. There a few properties you can add to change this behavior.

KBVersion: The name of the version to set as active

KBEnvironment: The name of the environment in that version

ProjectName: It will be the name of the generated .gxdproj file

ObjectNames: The names (with their types) of the objects to deploy (deployment units can also be selected) (ref.: How to specify an object list in a MSBuild task)

APPLICATION_KEY: The new encryption key to set for your deployed application

ApplicationServer: Take a look at the supported Deploy Application Servers for each platform

TARGET_JRE: (Java only) the version of the Java runtime where the deployed app will run. (Default is 9)

PACKAGE_FORMAT: (Java only) whether the engine must create a WAR or an EAR. (Default is 'Automatic', the engine decides based on the selected objects)

SelectedObjectsOnly: When set to true the deploy engine will not calculate the call tree of selected objects. Only the selected ones will be deployed.

TargetId: Default will be "Local", but you can set any of the supported Deploy Application Targets.

You can also use the CallTreeLogFile property to get a log of the objects call tree.


MSbuild.exe /nologo /verbosity:minimal /ToolsVersion:14.0 "c:\GeneXus\deploy.msbuild" 
/p:ApplicationServer="IIS8" /p:TargetId="Local" 

The generated .gxdproj file is another MSBuild script which contains the needed info to create the packaged application.


To generate the package (it can be a zip file in case of C# and .NET Core or a war/jar/ear in case of Java), you need to execute the generated script as follows:

msbuild.exe <Full path>\MSBuildDeployment_20190123103151.gxdproj

In this case, you can also set properties to tell the engine where the generated package will be deployed.

DeployFileFullPath: Full path to where you want the packaged app to be copied to.

DeployFullPath: Full path to which a copy of packaged files will be copied to. You can use this path to compare different deployments.

Deploy to external targets

The two tasks from above will create a package ready to be deployed to either your on-premises server or to any of the supported cloud providers (deployment targets). But GeneXus can also help you deploy this package to the desired target. 

Every supported target is listed under the DeploymentTargets folder under the GeneXus installation. All of these targets have a deploy.msbuild file with a default task called Deploy. Also, the needed properties for every script are declared in a file called Properties.xml. These are the properties that appear in the property grid in GeneXus.

Keep in mind that some scripts need common properties that may not be declared in the Properties.xml files, like DEPLOY_PATH or APPLICATION_NAME (all of them used in the previous tasks).


MSBuild.exe /nologo /verbosity:minimal /ToolsVersion:4.0 "c:\GeneXus\DeploymentTargets\Docker\deploy.msbuild" 

See Also