> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.ggcircuit.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Install Guide - ggRock Server Application

## This guide provides a walkthrough of necessary steps for installing the ggRock application for the first time.

#### Access Server Console

Access the server console via a direct keyboard/mouse/monitor connection to the server, SSH, or via Debian Control Panel.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191846.png?version=1&modificationDate=1747423129624&cacheVersion=1&api=v2)

#### Log in with an administrative user

Log in with the root user, or another administrative user on the system. This is the password set in the "Set Up Users and Passwords" section of the "Install the Debian OS on Your Server" guide. Once logged in successfully, you should see "root@ggrock:~#" which is the root prompt.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191912.png?version=1&modificationDate=1747423155065&cacheVersion=1&api=v2)

#### ggRock Automated Install Script

From the root prompt, initiate installation of ggRock via the automated install script by typing the following command and pressing "Enter" on the keyboard: wget -O - [ggrock.com/install.sh](http://ggrock.com/install.sh) | bash -

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191937.png?version=1&modificationDate=1747423180963&cacheVersion=1&api=v2)

#### Wait while ggRock and its dependencies are installed.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-192005.png?version=1&modificationDate=1747423208424&cacheVersion=1&api=v2)

#### Installation Complete

Confirm that installation has completed with a success message and the server IP where the ggRock Web UI will later be accessed.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-192027.png?version=1&modificationDate=1747423231457&cacheVersion=1&api=v2)

#### Reboot the server

Type "reboot" and press <ENTER>.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-192046.png?version=1&modificationDate=1747423249366&cacheVersion=1&api=v2)

#### Access Server Console

Log in as the root user or any other administrative user.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-192102.png?version=1&modificationDate=1747423265296&cacheVersion=1&api=v2)

#### Back Up Interfaces File

cp /etc/network/interfaces /etc/network/interfaces.bak

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-192120.png?version=1&modificationDate=1747423283374&cacheVersion=1&api=v2)

#### Open the interfaces file in a text editor

nano /etc/network/interfaces

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-192141.png?version=1&modificationDate=1747423304223&cacheVersion=1&api=v2)

#### Modify the interfaces file

Change the vmbr0 iface line to "static" instead of "DHCP", add the appropriate address, netmask, and gateway lines for your LAN.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-192159.png?version=1&modificationDate=1747423322584&cacheVersion=1&api=v2)

#### Save modified buffer

Press <CTRL> + <X> on the kebyoard, then at the "Save modified buffer?" prompt, press <y> on the keyboard to confirm saving the file.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191912.png?version=1&modificationDate=1747423155065&cacheVersion=1&api=v2)

#### File name to Write

Press <ENTER> to confirm writing the file to the location it was opened from.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191912.png?version=1&modificationDate=1747423155065&cacheVersion=1&api=v2)

#### Back Up resolv.conf

cp /etc/resolv.conf /etc/resolv.conf.baks

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191912.png?version=1&modificationDate=1747423155065&cacheVersion=1&api=v2)

#### Edit the resolv.conf file

nano /etc/resolv.conf

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191912.png?version=1&modificationDate=1747423155065&cacheVersion=1&api=v2)

#### Modify the resolv.conf file

Replace any contents with "nameserver 8.8.8.8" and "nameserver 8.8.4.4" each on their own line.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191912.png?version=1&modificationDate=1747423155065&cacheVersion=1&api=v2)

#### Save modified buffer

Press <CTRL> + <X> on the kebyoard, then at the "Save modified buffer?" prompt, press <y> on the keyboard to confirm saving the file.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191912.png?version=1&modificationDate=1747423155065&cacheVersion=1&api=v2)

#### File name to Write

Press <ENTER> to confirm writing the file to the location it was opened from.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191912.png?version=1&modificationDate=1747423155065&cacheVersion=1&api=v2)

#### Reboot the server

Type "reboot" and press <ENTER>.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191912.png?version=1&modificationDate=1747423155065&cacheVersion=1&api=v2)

#### Access Server Console

Log in as the root user or any other administrative user.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191912.png?version=1&modificationDate=1747423155065&cacheVersion=1&api=v2)

#### Run Configurator

Run the "ggrock-linux-configurator" command.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191912.png?version=1&modificationDate=1747423155065&cacheVersion=1&api=v2)

#### Accept adding "contrib" to all repositories

Press <ENTER> to confirm addition of the 'contrib' component(s) to all repositories.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191937.png?version=1&modificationDate=1747423180963&cacheVersion=1&api=v2)

#### Configurator Complete

When configurator is completed, a result of "net.ipv4.ip_forward = 1" is considered to be a success.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191937.png?version=1&modificationDate=1747423180963&cacheVersion=1&api=v2)

#### Exit Server Console

Type "exit" and press the <ENTER> key.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191937.png?version=1&modificationDate=1747423180963&cacheVersion=1&api=v2)

#### Server Console

At the end of ggRock Server Application installation, you should leave your console secured at the login screen. 

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863147/image-20250516-191937.png?version=1&modificationDate=1747423180963&cacheVersion=1&api=v2)