Skip to content

Installation

Michael Yan edited this page Apr 7, 2024 · 1 revision

GRACE CLI - INSTALLATION

Thank you for downloading the Grace CLI. Please follow these instructions in order to complete your installation.

Manual Installation

Prerequisites

Grace CLI requires Java JDK v11.0 or above in order to run. Groovy v3.0.x is packaged as part of this distribution, and therefore does not need to be installed (any existing Groovy installation is ignored).

Grace CLI will use whatever JDK it finds on your path, to check that you have an appropriate version you should run:

java -version

Alternatively, you can set the JAVA_HOME environment variable to point a suitable JDK.

Environment Variables

No specific environment variables are required to run the CLI, however, you may want to set GRACE_HOME to point to a specific installation. You should also add GRACE_HOME/bin to your PATH environment variable.

Checking Your Installation

To test if you have successfully installed the CLI you can run the following command:

$ grace -v

------------------------------------------------------------
Grace 2022.0.0
------------------------------------------------------------

Build time:   2024-01-17 18:37:19 UTC
Revision:     0747fc73e29bf1e53d79049c4fddba51dbe54f34

Spring Boot:  2.7.9
Gradle:       7.6.1
Groovy:       3.0.15
JVM:          11.0.22 (Azul Systems, Inc. 11.0.22+7-LTS)
OS:           Mac OS X 12.7.4 aarch64

Installation with SDKMAN!

SDKMAN! (The Software Development Kit Manager) can be used for managing multiple versions of various binary SDKs, including Groovy and the Grace CLI.

Get SDKMAN! from sdkman.io and install Grace CLI by using the following commands:

$ sdk install grace
$ grace -v

------------------------------------------------------------
Grace 2022.0.0
------------------------------------------------------------

Build time:   2024-01-17 18:37:19 UTC
Revision:     0747fc73e29bf1e53d79049c4fddba51dbe54f34

Spring Boot:  2.7.9
Gradle:       7.6.1
Groovy:       3.0.15
JVM:          11.0.22 (Azul Systems, Inc. 11.0.22+7-LTS)
OS:           Mac OS X 12.7.4 aarch64