Startup and Shutdown

    App Studio has two scripts for startup and shutdown in the root directory of an App Studio project (app-studio):

    • app-studio.sh – A Bash script for Linux and macOS

    • app-studio.bat – A batch file for Windows

    You also use these scripts to build an app from source.

    Obtain usage information

    For usage information, enter:

    • Linux and macOS: ./app-studio.sh -help

    • Windows: app-studio.bat -help

    For command-specific usage information, enter:

    • Linux and macOS: ./app-studio command -help

    • Windows: app-studio.bat command -help

    Below, optional parameters are indicated by square brackets, which you don’t type.

    Startup commands

    • Linux and macOS: ./app-studio start [--production] [-f] [-p port] [-m memory] [-t timeout] [-V]

    • Windows: app-studio.bat start [-f] [-p port] [-m memory] [-t timeout] [-V]

    Shutdown commands

    • Linux and macOS: ./app-studio stop [-p port] [-V]

    • Windows: app-studio.bat stop [-p port] [-V]

    Parameters

    Bold italic text is a placeholder for a value. For example, for -m memory you might use -m 4g.

    Parameter Description

    --production

    Start the app in production mode, which disables the configuration wizard and the code editor.

    -f

    Start App Studio in the foreground. By default, App Studio starts in the background.

    -p port

    Specify the port on which the App Studio web server will listen. The default port is 8080.

    -m memory

    Set the minimum (-Xms) and maximum (-Xmx) heap size for the JVM. For example, -m 4g results in: -Xms4g -Xmx4g. The default heap size is 512m.

    -t timeout

    Set the startup timeout in seconds.

    -V

    Output verbose messages from the script.

    Starting and stopping multiple App Studio instances

    You can run multiple instances of App Studio on a single host by specifying different ports for all instances. Do this on startup, at the command line, using the -p parameter, for example:

    ./app-studio.sh start -p 9000

    When running multiple instances, also use the -p flag to indicate which instance of App Studio to shut down, for example:

    ./app-studio.sh stop -p 9000

    What’s next