How to Start JBoss Application Server

  1. To start JBoss, run $JBOSS_HOME/bin/ on Unix/Linux and %JBOSS_HOME%run.bat on Windows
  2. The script figures out JBOSS_HOME by itself - though it does not hurt to have it pre-specified.
  3. By default, this script runs the default configuration set

    1. Alternative configuration set can be specified: ./ -c <configuration_set_name>

  4. By default, this script binds JBoss AS to (for security reasons) making it inaccessible from the outside world

    1. To bind JBoss to a specific address, execute: ./ -b or ./ --host=
    2. To bind JBoss to all addresses, execute: ./ -b or ./ --host=

  5. To start JBoss as a system service

    1. On Unix/Linux, use a script like

      1. Copy (or symbolically link) this script to /etc/init.d/jboss
      2. Edit the script as needed (to specify user, IP, and file paths)
      3. Add #chkconfig: 3 80 20 and #description: JBoss to this script
      4. Run chkconfig --add jboss

    2. On Windows use JavaService (, which comes with an installation script for JBoss

 Inclined to build a profession as JBOSS Developer? Then here is the blog post on "JBOSS Training "

Usage: run.bat [options]


  • h, --help                   Show this help message
  • V, --version                 Show version information
  • -                           Stop processing options
  • D<name>[=<value>]           Set a system property
  • d, --bootdir=<dir>           Set the boot patch directory; Must be absolute or url
  • p, --patchdir=<dir>         Set the patch directory; Must be absolute or url
  • n, --netboot=<url>           Boot from net with the given url as base
  • c, --configuration=<name>   Set the server configuration name
  • B, --bootlib=<filename>     Add an extra library to the front bootclasspath
  • L, --library=<filename>     Add an extra library to the loaders classpath
  • C, --classpath=<url>         Add an extra url to the loaders classpath
  • P, --properties=<url>       Load system properties from the given url
  • b, --host=<host or ip>       Bind address for all JBoss services
  • g, --partition=<name>       HA Partition name (default=DefaultDomain)
  • m, --mcast_port=<ip>         UDP multicast port; only used by JGroups
  • u, --udp=<ip>               UDP multicast address
  • l, --log=<log4j|jdk>         Specify the logger plugin type

On Unix/Linux, (and source JVM/runtime options from run.conf file whereas on Windows run.bat specifies those options internally.

Verifying JBoss AS Startup

JBoss has successfully started when in its console window you can see a line like this:

13:26:33,625 INFO [ServerImpl] JBoss (Microcontainer) [5.1.0.GA (build: SVNTag=JBoss_5_1_0_GA date=200905221634)] Started in 2m:20s:844ms

If you see any exception traces, then there was a problem starting one or more of the JBoss services. Examine the error messages before continuing. A common problem is a port conflict: another server (possibly another instance of JBoss AS itself) is running on one or more of the required JBoss AS ports.

Point your browser to http://localhost:8080/status to verify the server startup.

How to Stop JBoss Application Server

Stopping JBoss Application Server

If started in the foreground using the run script, simply hit CTRL+C.

If running in the background as an OS service, stop it just like any other OS service.

  1. /etc/init.d/jboss stop (on UNIX/Linux)
  2. kill -TERM <jboss-pid> (on UNIX/Linux)
  3. NET STOP JBoss (on Windows)

Use the shutdown script (remote shutdown): $JBOSS_HOME/bin/ -S (shutdown.bat on Windows)

A JMX client to shutdown (exit or halt) a remote JBoss server.

Usage: shutdown [options] <operation>


  • h, --help               Show this help message (default)
  • D<name>[=<value>]       Set a system property
  • -                       Stop processing options
  • s, --server=<url>       Specify the JNDI URL of the remote server
  • n, --serverName=<url>   Specify the JMX name of the ServerImpl
  • a, --adapter=<name>     Specify JNDI name of the MBeanServerConnection to use
  • u, --user=<name>         Specify the username for authentication
  • p, --password=<name>     Specify the password for authentication
  • operations:
  • S, --shutdown           Shutdown the server
  • e, --exit=<code>         Force the VM to exit with a status code
  • H, --halt=<code>         Force the VM to halt with a status code

To shut down a remote JBoss AS instance, use: ./ -s jnp://remoteHostOrIP:1099 -S Remote instance’s IP address and port are specified by its Naming service configured in ${jboss.server.config.url}/jboss-service.xml

For an in-depth understanding on JBoss click on: