sbt-native-packager

# SBT Native Packager #

[![Build Status](https://github.com/sbt/sbt-native-packager/actions/workflows/validate-pr.yml/badge.svg?event=push)](https://github.com/sbt/sbt-native-packager/actions/workflows/validate-pr.yml)
[![Build status](https://ci.appveyor.com/api/projects/status/pbxd0untlcst4we7/branch/master?svg=true)](https://ci.appveyor.com/project/muuki88/sbt-native-packager/branch/master)
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/0e9a7ec769c84e578f4550bf7da6bf05)](https://www.codacy.com/app/nepomukseiler/sbt-native-packager?utm_source=github.com&utm_medium=referral&utm_content=sbt/sbt-native-packager&utm_campaign=Badge_Grade)
[![sbt-native-packager Scala version support](https://index.scala-lang.org/sbt/sbt-native-packager/sbt-native-packager/latest-by-scala-version.svg?targetType=Sbt)](https://index.scala-lang.org/sbt/sbt-native-packager/sbt-native-packager)
[![Join the chat at https://gitter.im/sbt/sbt-native-packager](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/sbt/sbt-native-packager?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Documentation Status](https://app.readthedocs.org/projects/sbt-native-packager/badge/?version=latest)](https://sbt-native-packager.readthedocs.io/en/latest/?badge=latest)


![Native Packager Logo](src/sphinx/static/np_logo_full_horizontal_transparent.png)

## Goal ##

SBT native packager lets you build application packages in native formats. It offers
different archetypes for common configurations, such as simple Java apps or server applications.

## Issues/Discussions ##

*  **Discussion/Questions**:
  If you wish to ask questions about the native packager we're active on [Stack Overflow](https://stackoverflow.com/questions/tagged/sbt). 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](https://sbt-native-packager.readthedocs.io/en/latest/).  If you'd like to help improve the docs, they're part of this
  repository in the `src/sphinx` directory. [ScalaDocs](https://www.scala-sbt.org/sbt-native-packager/latest/api/#package) are also available.

  The old documentation can be found [here](https://www.scala-sbt.org/sbt-native-packager/)
* **Issues/Feature Requests**:
  Finally, any bugs or features you find you need, please report to our [issue tracker](https://github.com/sbt/sbt-native-packager/issues/new).
  Please check the [compatibility matrix](https://github.com/sbt/sbt-native-packager/wiki/Tested-On) to see if your system is able to
  produce the packages you want.

## Features ##

* Build [native packages][formats] for different systems
  * Universal `zip`,`tar.gz`, `xz` archives
  * `deb` and `rpm` packages for Debian/RHEL based systems
  * `dmg` for macOS
  * `msi` for Windows
  * `docker` images
  * `graalvm` native images
* Provide archetypes for common use cases
  * [Java application][] with s