SBT Native Packager
|Travis||Universal, Debian, Rpm and Jar tests|
|Bintray||Latest Version on Bintray|
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.
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
sbttag or the
sbt-native-packagertag. They also have far better search support for working around issues.
Our docs are available online. If you'd like to help improve the docs, they're part of this
repository in the
src/sphinxdirectory. 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.
- Build native packages for different systems
rpmpackages for Debian/RHEL based systems
- Provide archetypes for common use cases
- Java application with startscripts for linux/osx/windows
- Java server additional autostart configurations
Add the following to your
// for autoplugins addSbtPlugin("com.typesafe.sbt" % "sbt-native-packager" % "1.0.3")
build.sbt enable the plugin you want. For example the
For non-autoplugins use the
addSbtPlugin("com.typesafe.sbt" % "sbt-native-packager" % "0.8.0")
For the native packager keys add this to your
build.sbt if you use the a version
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 Native Packages via
JDK 8 from Oracle includes the tool
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
and passing them through
This plugin's most significant complement to the core
sbt-native-packager capabilities is the
generation of MacOS X App bundles, and associated
.pkg package formats.
It can also generate Windows
.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.