1. ggCircuit Help Center
  2. ggRock User Manual
  3. Installation - ggRock Server Application

First-time Setup and Accessing the ggRock Server Application

This article describes necessary steps for accessing the ggRock Server Application (ggRock Web UI) for the first time.

Table of Contents

Executive Summary

Required Time: 10 Minutes

Description: Accessing the ggRock server application is accomplished via a web browser. First-time setup involves logging in with a ggLeap account for your center that has the necessary permissions, optionally changing the password for that account, and logging in for the first time. Before following this guide, ensure that you have followed the "Install the Debian OS on Your Server" and "Install the ggRock Server Application" guides.

Access the Server Console

1. Access the server console via a direct keyboard/mouse/monitor connection to the server, SSH, or via Debian Control Panel. Your Server IP will be displayed in the login banner.

NOTE:

In the case of the example, this address is 192.168.1.66, however your Server IP will be unique to your LAN configuration.

Open the ggRock Server Web UI

2. Open a web browser on any PC on the same network segment as your ggRock server, and enter your Server IP in the address bar, then press the "Enter" key on your keyboard.

NOTE:

In the example, the Google Chrome browser is used so it is necessary to accept the ggRock self-signed SSL certificate by clicking the "Advanced" button, then clicking the "Proceed to 192.168.1.66 (unsafe)" link. This process is safe as long as you followed ggCircuit-provided guides start-to-finish with no outside interference.

Log into ggRock for the First Time

3. During your purchase your sales manager should provide you with your ggRock credentials. Enter them in the fields provided. This will be an account of your choosing that exists as an Employee within your ggLeap instance.

NOTE:
The owner permission within ggRock is tied to the first ggLeap account you sign into ggRock with that has the "Can get GG rock AuthToken" permission. It is for this reason that it is recommended to create a new ggLeap Employee Account to use as a service account for ggRock authentication. This avoids a discouraged practice of sharing a personal user account/password amongst multiple users, as additional administrators of the ggRock server may be added at a later time.

4. Navigate to Settings > Employees > Employees list.

5. Click the "Add employee" button.

6. Set a username and password for the account, and ensure it has the following permission:

"Can get GG rock AuthToken"

7. Log into the ggRock Web UI with the ggLeap Employee account you created above.

8. You will be prompted to change your password so nobody else knows it and we eliminate any dangers with the communication mediums used to send you your initial credentials.

Confirm Successful Login

9. Upon successful login you should end up on the Machines page with no entries.

You may now proceed with the "Configure the ggRock Array" guide.