This documentation is for Octopus Deploy Version 3.9. View other versions

Calamari on Mono

Last updated

Calamari can execute on the Mono framework, allowing Octopus to deploy via SSH to *nix operating systems.

Version 3.10 or greater of Mono is required.

You can find instructions for installing Mono in the Mono documentation.

Supported Distros

Mono supports many platforms.

We currently execute automated tests against the following platforms:

  • Centos 7.3 + Mono 4.4.2
  • Debian 8.7 + Mono 4.4.2
  • Fedora 23 + Mono 4.4.2
  • FreeBSD 10.3 + Mono 4.6.2
  • Mac OSX 10.12.5 + Mono 4.6.1
  • openSUSE 13.2 + Mono 4.6.0
  • Redhat 7.2 + Mono 4.4.2
  • SUSE LES 12 SP2 + Mono 4.6.0
  • Ubuntu 12.04 LTS + Mono 3.12.1
  • Ubuntu 14.04 LTS + Mono 4.0.5
  • Ubuntu 16.04 LTS + Mono 4.6.1


Configuration Transformations only available in Mono >= 4.2.3

The Configuration Transforms feature will only work on Mono 4.2.3 and above.

This was due to a bug with XML Transformations.

Note that Substitute Variables in Files can still be used without issue on earlier Mono versions.

Package Repository SSL Certificates

If you configure your deployment such that the target pulls down the package itself directly from the NuGet repository, the correct SSL certificates need to also be available to Mono. By default, Mono pre 3.12 didn’t trust any certificates and the root certs in question would need to be either manually imported, or synced with Mozilla’s list by invoking mozroots or cert-sync. Thankfully Mono's latest builds perform this step during installation so it should “just work”. See Mono’s security FAQ for more details.

ScriptCS and F# only in >= Mono 4.0

Support for ScriptCS and F# scripts are only available with Mono 4 and above.