> ## 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).

# IV. - 🖥 Install the ggRock Server Application

| This guide walks you through the first-time installation of the ggRock Server Application. The process is mostly automated 🛠️ but does include some command-line work and basic file editing.

### Table of Contents

* [**I. -📥 How to Download Debian and Rufus**](https://helpdesk.ggcircuit.com/en/article/i-how-to-download-debian-and-rufus-1mctc5r/)
* [**II. - 💾 Create a Bootable Debian Installer**](https://helpdesk.ggcircuit.com/en/article/ii-create-a-bootable-debian-installer-1kxab79/)
* [**III. - 🐧 Install Debian Linux**](https://helpdesk.ggcircuit.com/en/article/iii-install-debian-linux-13-14qgozu/)
* [**IV. - 🖥 Install the ggRock Server Application**](https://helpdesk.ggcircuit.com/en/article/iv-install-the-ggrock-server-application-1r0g9sn/) 🎯 You Are Here
* [**V. - 🚀 First-time Setup and Accessing the ggRock Server Application**](https://helpdesk.ggcircuit.com/en/article/v-first-time-setup-and-accessing-the-ggrock-server-application-1pudbnd/)
* [**VI. - ⚙️ Configure the ggRock Array**](https://helpdesk.ggcircuit.com/en/article/vi-configure-the-ggrock-array-mkgkfy/)
* [**VII. - 🖼️ Create, Configure, and Test ggRock Images**](https://helpdesk.ggcircuit.com/en/article/vii-create-configure-and-test-ggrock-images-11jl7lm/)
* [**VIII. - 🖧 Configure Client Machines for Network/Diskless (PXE) Boot**](https://helpdesk.ggcircuit.com/en/article/viii-configure-client-machines-for-networkdiskless-pxe-boot-ey4vsf/)

---

## 🖥️ Access the Server Console

1. Connect to the server via:

* Direct keyboard/mouse/monitor
* SSH
* Debian Control Panel

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-161824.png?version=1&modificationDate=1743697106976&cacheVersion=1&api=v2)

2. Log in as the `root` user or another administrative user. You should see the prompt:

```
   root@ggrock:~#
```

   🔐 **Note**: Ensure CAPS LOCK is off if login fails.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-161847.png?version=1&modificationDate=1743697130359&cacheVersion=1&api=v2)

---

## ⚙️ Run the ggRock Automated Install Script

3. Enter the following command at the root prompt:

```
   wget -O - https://www.ggrock.com/install.sh | bash -
```

   ⚠️ **Important**:

* The `O` is a capital letter, not the number zero.
* Spaces and formatting must be exact.
* If using SSH or the Debian Control Panel, feel free to copy/paste.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-161911.png?version=1&modificationDate=1743697154692&cacheVersion=1&api=v2)

---

## 📦 Automated Installation (Sit Back & Relax 😎)

4. The script will now install ggRock and its dependencies. This takes **10–15 minutes** depending on server and network speed.

☕ Grab a coffee — you’ve earned it!

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-162529.png?version=1&modificationDate=1743697532173&cacheVersion=1&api=v2)

5. After successful installation, you'll see a message with a local address like:

```
[http://your.server.ip.address.here/](http://your.server.ip.address.here/)
```

🌐 This is your access point for the ggRock Web UI.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-163039.png?version=1&modificationDate=1743697842464&cacheVersion=1&api=v2)

6. Reboot the server:

```
reboot
```
![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-163056.png?version=1&modificationDate=1743697859039&cacheVersion=1&api=v2)

---

## 🌐 Update Network Configuration

7. Log back into the server console as root.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-163120.png?version=1&modificationDate=1743697883625&cacheVersion=1&api=v2)

8. Back up your current network config:

```
cp /etc/network/interfaces /etc/network/interfaces.bak
```
![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-163252.png?version=1&modificationDate=1743697975763&cacheVersion=1&api=v2)

9. Open the file for editing:

```
nano /etc/network/interfaces
```
![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-163315.png?version=1&modificationDate=1743697998053&cacheVersion=1&api=v2)

10. Replace:

```
auto vmbr0
iface vmbr0 inet dhcp
```

With:

```
auto vmbr0
iface vmbr0 inet static
address SERVERIP
netmask NETMASK
gateway GATEWAY
```
> 📌 Replace placeholders with actual values based on your network setup.

Then ensure your file resembles:

```
auto lo
iface lo inet loopback
auto vmbr0
iface vmbr0 inet static
address SERVERIP
netmask NETMASK
gateway GATEWAY
bridge_ports ens33
bridge_fd 0
bridge_stp off
iface ens33 inet manual
```
> 🔍 `ens33` may differ based on your server — adjust accordingly.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-163415.png?version=1&modificationDate=1743698058944&cacheVersion=1&api=v2)

11. Save and exit:  
    Press `CTRL + X`, then `Y`, then **Enter**.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-161847.png?version=1&modificationDate=1743697130359&cacheVersion=1&api=v2)

---

## 🌍 Update DNS Configuration

12. Back up your DNS config:

```
cp /etc/resolv.conf /etc/resolv.conf.bak
```
![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-161847.png?version=1&modificationDate=1743697130359&cacheVersion=1&api=v2)

13. Open the DNS file:

```
nano /etc/resolv.conf
```
![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-161847.png?version=1&modificationDate=1743697130359&cacheVersion=1&api=v2)

14. Replace:

```
nameserver 192.168.1.1
```

With:

```
nameserver 8.8.8.8
nameserver 8.8.4.4
```
![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-161847.png?version=1&modificationDate=1743697130359&cacheVersion=1&api=v2)

15. Save and exit:  
    Press `CTRL + X`, then `Y`, then **Enter**.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-161847.png?version=1&modificationDate=1743697130359&cacheVersion=1&api=v2)

16. Reboot the server again:

```
reboot
```
![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-161847.png?version=1&modificationDate=1743697130359&cacheVersion=1&api=v2)

---

## 🧰 Run the ggRock Linux Configuration Utility

> 💡 **TIP**: You can launch the configuration utility at any time using:
>
> ```
> ggrock-linux-configurator
> ```

17. Log back into the server console as root.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-161847.png?version=1&modificationDate=1743697130359&cacheVersion=1&api=v2)

🔎 **Note**: If your server has multiple active network interfaces, you’ll see steps 4–9. If not, skip ahead.

18. Run the `ggrock-linux-configurator` command.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15861727/image-20250403-161847.png?version=1&modificationDate=1743697130359&cacheVersion=1&api=v2)

---

🎉 **Installation Complete!**

✅ You're now ready to proceed to the **“**[**First-Time Setup and Accessing the ggRock Server Application**](https://helpdesk.ggcircuit.com/en/article/v-first-time-setup-and-accessing-the-ggrock-server-application-1pudbnd/)**”** guide.

> 🧠 *Optional*: To manage ggRock remotely, check out the [**Access Debian Control Panel**](https://helpdesk.ggcircuit.com/en/article/accessing-the-debian-control-panel-optional-but-recommended-1rryyk8/) article.

---