Fuses a Payload together with the Components it requires into an Image.

Usage: boxfuse fuse payload

If no Payload is specified, Boxfuse will search for a suitable one in the current directory.

> boxfuse fuse hello-1.0.war

Fusing Image for hello-1.0.war ...
Image fused in 00:07.351s (48147 K) -> axelfontaine/hello:1.0

Supported Payload formats:

  • Executable jar file
  • War file
  • Play dist zip
  • Node.js tgz
  • ELF64 binary
  • Revel tar.gz


Argument boxfuse.conf property Default Description
-cmd=... cmd first executable file in image

Generic Linux x64 apps only

The command to start the app including relative path and all necessary arguments
-components.NAME=version components.NAME latest version Pins the component with this name onto this version.
Example: -components.tomcat=8.0.9
-debug debug false Start the Payload in debug mode when an Instance launches
-debug.wait debug.wait false

JVM apps only

Whether the JVM should wait for the remote debugger to connect (Only applicable when debug mode is active)
-envvars.NAME=value envvars.NAME Fuses this environment variable into the image and make it available at runtime
Example: -envvars.JDBC_URL=jdbc:mydburl
-healthcheck healthcheck true Check whether to payload started correctly
-healthcheck.port=... healthcheck.port autodetected The port to check whether to payload started correctly (ex.: http)
-healthcheck.path=... healthcheck.path / The path to check whether to payload started correctly
-healthcheck.timeout=... healthcheck.timeout 300 The number of seconds to wait for the Payload to come up
-jvm.args=... jvm.args

JVM apps only

Extra arguments to pass to the JVM
-jvm.jmx jvm.jmx false

JVM apps only

Enable the JMX remote management and profiling interface for the JVM
-jvm.main.class=... jvm.main.class autodetected

JVM apps only

Main class to invoke on JVM startup
-jvm.main.args=... jvm.main.args

JVM apps only

Arguments to pass to the main class
-live live false Enable live reloading of changes in dev for super fast round-trips. Note that images with live reloading cannot be pushed to the Boxfuse Vault.
-newrelic.licensekey=... newrelic.licensekey Installs and configures the New Relic agents to monitor your instance.
-payload.port payload.port autodetected The main port on which the payload starts (usually http or https)
-payload.path payload.path / The path where the payload starts
-ports.NAME=definition ports.NAME http=80

Exposes the port of the app with this name using this definition. Example: -ports.jmx=8001

Supported formats:

80TCP port 80, universally accessible
80/tcpTCP port 80, universally accessible
80/udpUDP port 80, universally accessible
80/tcp:@TCP port 80 only accessible from your own IP
80/udp:@/20UDP port 80 only accessible from the IPs in the CIDR /20 block of your own IP
80/udp: port 80 only accessible from
80/tcp: port 80 only accessible from the IPs in the CIDR /31 block of
-tmp=... tmp 1 The amount of temp space to allocate to /tmp in GB
-vault vault false Immediately upload the new Image to the Boxfuse Vault