Get Started with Katalium Server
Set up Katalium Server
-
Install Java. The recommended version is Java 8.
-
Download and extract the latest release of the Katalium Server from here. The
kata-server.jar
can be executed in Standalone, Grid Hub, or Grid Node modes. -
Set up Katalium Server by using Command Line.
Standalone mode
To start the server in the standalone mode, execute standalone.sh
file (in macOS and Linux) or standalone.bat
file (in Windows) with these commands:
cd katalium-server
standalone.bat
cd katalium-server
chmod u+x ./standalone.sh
./standalone.sh
Successfully activated Katalium Server will be displayed as belows:
When you activate the server for the first time, you have to enter the email and password of your Katalon Account. It is recommended to use Katalon API Keys instead of your account's password. Refer to Katalon API Keys for further details.
KATALON_EMAIL: Enter your Katalon account. If you don't have an account, sign up here: Sign up.
KATALON_API_KEY: Enter the API Key.
If you want to re-activate Katalium Server, you have to removeframework.properties
file in .katalon
folder.
Grid Mode
Grid Hub
To start Katalium Server as a Grid Hub, execute hub.sh
file (in macOS and Linux) or hub.bat
file (in Windows) with these commands:
cd katalium-server
hub.bat
cd katalium-server
chmod u+x ./hub.sh
./hub.sh
See Standalone mode for activation steps.
Grid Node
Before executing the scripts, please set the Hub URL in nodeConfigForWindow.json
(for Windows) or nodeConfig.json
(for macOS and Linux) so that Grid Nodes can register themselves with the above Grid Hub, e.g. http://hub_ip:4444
.
To start Katalium Server as a Grid Node, execute node.sh
file (in macOS and Linux) or node.bat
file (in Windows).
cd katalium-server
node.bat
cd katalium-server
chmod u+x ./node.sh
./node.sh
See Standalone mode for activation steps.