io7m | single-page | multi-page | epub | Montarre User Manual 1.0.0-beta0001
1. Overview
Previous
Front Matter
Up
3. Usage
Next

# 2. Installation

- 2.1. Overview
- 2.2. Shaded Jar

## 2.1. Overview

1
There are several ways to install the montarre tool. Regardless of the installation method, the included command-line tool will present the same interface. The documentation is written in terms of executing a command-line tool named montarre. Some installation methods, however, won't result in an executable named montarre being installed. For example, the shaded jar is, unsurprisingly, a jar file. When using this installation method, one should mentally substitute "java -jar com.io7m.montarre.cmdline-1.0.0-beta0001-main.jar" whenever the documentation mentions the montarre command.

## 2.2. Shaded Jar

1
The shaded jar distribution is simply a so-called onejar consisting of all of the application bytecode packed into a single jar file.
2
Download the jar file signature from Maven Central.

### 2.2.3. Shaded Jar Signature Download

    $ wget https://repo1.maven.org/maven2/com/io7m/montarre/com.io7m.montarre.cmdline/1.0.0-beta0001/com.io7m.montarre.cmdline-1.0.0-beta0001-main.jar.asc

4
Download the jar file from Maven Central.

### 2.2.5. Shaded Jar Download

    $ wget https://repo1.maven.org/maven2/com/io7m/montarre/com.io7m.montarre.cmdline/1.0.0-beta0001/com.io7m.montarre.cmdline-1.0.0-beta0001-main.jar

6
Verify the signature:

### 2.2.7. Shaded Jar Signature Verification

    $ gpg --verify com.io7m.montarre.cmdline-1.0.0-beta0001-main.jar.asc

8
Run the jar using an appropriate Java runtime:

### 2.2.9. Shaded Jar Execution

    $ java -jar com.io7m.montarre.cmdline-1.0.0-beta0001-main.jar
    montarre: usage: montarre [command] [arguments ...]

      The montarre command-line application.

      Use the "help" command to examine specific commands:

        $ montarre help help.

      Command-line arguments can be placed one per line into a file, and
      the file can be referenced using the @ symbol:

        $ echo help > file.txt
        $ echo help >> file.txt
        $ montarre @file.txt

      Commands:
        help             Show usage information for a command.
        maven-central    Maven Central commands.
        native           Native package commands.
        package          Package commands.
        version          Show the application version.
        wix              WiX commands.

      Documentation:
        https://www.io7m.com/software/montarre/

1. Overview
Previous
Front Matter
Up
3. Usage
Next
io7m | single-page | multi-page | epub | Montarre User Manual 1.0.0-beta0001