Scroll to navigation

SBT(1) User Manuals SBT(1)

NAME

sbt - Simple Build Tool

SYNOPSIS

sbt [-h] [-sbt-version sbt-version ] <commands> ...

DESCRIPTION

sbt Runs the Simple Build Tool using the currently installed java(1) The current directory is assumed to be the project.

OPTIONS

Show help options.
turn up the noise
set sbt log level to debug
disable ANSI color codes
start sbt even if current directory contains no sbt project
path to global settings/plugins directory (default: ~/.sbt)
path to shared boot directory (default: ~/.sbt/boot in 0.11 series)
path to local Ivy repository (default: ~/.ivy2)
set memory options (default: $sbt_mem, which is $(get_mem_opts $sbt_mem))
use all local caches; no sharing
uses global caches, but does not use global ~/.sbt directory.
Turn on JVM debugging, open at the given port.
Disable interactive mode
put sbt in offline mode

SBT Version Options

Use the alternate system wide sbt-version The Simple Build Tool version to use. This script will download necessary versions using the curl(1) tool.
use the specified jar as the sbt launcher
use an RC version of sbt
use a snapshot version of sbt

Java Options

alternate JAVA_HOME
pass -Dkey=val directly to the java runtime
pass option -X directly to the java runtime (-J is stripped)
add -X to sbt's scalacOptions (-S is stripped)

FILES

~/.sbt

The user configuration file.
.jvmopts
if this file exists in the current directory, its contents are appended to the JAVA_OPTS.
.sbtopts
if this file exists in the current directory, its contents are prepended to the runner args.
/etc/sbt/sbtopts
if this file exists, it is prepended to the runner args

ENVIRONMENT

If non-null a set of arguments passed to java.
environment variable, if unset uses "$default_sbt_opts".

EXAMPLES

Most users of this script will only have to call "sbt" on the command line.

AUTHOR

Paul Phillips <paulp@typesafe.com>

NOVEMBER 2011 Linux