Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

SBT Native Packager

Join the chat at

Build Status Codacy Badge Build status

This is a work in progress project. The goal is to be able to bundle up Scala software built with SBT for native packaging systems, like deb, rpm, homebrew, msi.

Announcement - 1.0.0 will require Java 7 or higher

The next release will require java 7 or higher. If you need java 6, please join the discussion in #498.


  • Discussion/Questions: If you wish to ask questions about the native packager, we have a mailinglist and we're very active on Stack Overflow. You can either use the sbt tag or the sbt-native-packager tag. They also have far better search support for working around issues.
  • Docs: Our docs are available online. If you'd like to help improve the docs, they're part of this repository in the src/sphinx directory. ScalaDocs are also available.
  • Issues/Feature Requests: Finally, any bugs or features you find you need, please report to our issue tracker. Please check the compatibility matrix to see if your system is able to produce the packages you want.


Add the following to your project/plugins.sbt file:

// for sbt 0.12.x and scala 2.9.x
addSbtPlugin("com.typesafe.sbt" % "sbt-native-packager" % "0.7.7-RC1")

// for sbt 0.13.x and scala 2.10.x
addSbtPlugin("com.typesafe.sbt" % "sbt-native-packager" % "0.8.0")

// for autoplugins
addSbtPlugin("com.typesafe.sbt" % "sbt-native-packager" % "1.0.0-RC1")

For the native packager keys add this to your build.sbt

import NativePackagerKeys._

Experimental systemd bootsystem support

Native packager now provides experimental systemd startup scripts. Currently it works on Fedora Fedora release 20 (Heisenbug) and doesn't work on Ubuntu because of partial systemd support in Ubuntu 14.04 LTS. To enable this feature follow My First Packaged Server Project guide and use Systemd as server loader:

import com.typesafe.sbt.packager.archetypes.ServerLoader.Systemd
serverLoading in Rpm := Systemd

Any help on testing and improving this feature is appreciated so feel free to report bugs or making PR.

Experimental Docker support

Native packager now provides experimental Docker images. Docker version 1.3 or higher is required. To enable this feature follow Docker Plugin guide and use one of the provided Docker tasks for generating images.

To publish the image, dockerRepository should be set.

As with the systemd support, help with testing and improvements is appreciated.

Experimental JDeb support

If don't run a linux or mac system with dpkg installed, you can configure the debian packaging be done by jdeb. To enable this just set another packaging implementation in your build.sbt

packageBin in Debian <<= debianJDebPackaging in Debian

Experimental Native Packages via javapackager

JDK 8 from Oracle includes the tool javapackager (née javafxpackager) to generate application launchers and native installers for MacOS X, Windows, and Linux. This plugin complements the existing sbt-native-packager formats by taking the settings and staged output from JavaAppPackaging and passing them through javapackager.

This plugin's most significant complement to the core sbt-native-packager capabilities is the generation of MacOS X App bundles, and associated .dmg and .pkg package formats. It can also generate Windows .exe and .msi installers provided the requisite tools are available on the Windows build platform.

For usage details see the JDKPackager Plugin guide.


There's a complete "getting started" guide and more detailed topics available at the sbt-native-packager site.

Please feel free to contribute documentation, or raise issues where you feel it may be lacking.

Something went wrong with that request. Please try again.