Active Directory Support

Enabling Active Directory Support in ggRock

This guide outlines the steps to enable Active Directory (AD) Support for your system images within the ggRock Web UI.

Once configured, any machine booting from the modified image will automatically attempt to bind to your AD domain.

⚠️ Critical Requirement: NetBIOS Naming Conventions

Before enabling Active Directory, ensure your Machine Names in ggRock adhere to Microsoft NetBIOS standards.

Failure to follow these rules will prevent machines from successfully joining the domain.

• Maximum Length: Names must be 15 characters or fewer.
• No Spaces: Do not use spaces within the machine name.
• Allowed Characters: Use only letters (A-Z), numbers (0-9), and hyphens (-).
• Prohibited Characters: Do not use special characters such as: \ / : * ? " < > | . @ [ ] { } + = ; ,
• No Period/Dot: Unlike DNS names, NetBIOS names cannot contain periods.

Step-by-Step Instructions

1. Navigate to the Images Tab

Open the ggRock Web UI. From the navigation menu on the left-hand side, click on the Images tab.

2. Edit the Target Image

Locate the specific system image you wish to join to the domain. Hover your mouse over the image row to reveal the action icons on the right, then click the Pencil (Edit) icon.

3. Toggle Active Directory Support

In the "Edit Image" dialog box, locate the Enable Active Directory toggle switch and click it to the On position. This will expand the credential fields.

4. Enter Domain Information

Enter the required administrative information for your network.

• Username: An account with permissions to join machines to the domain.
• Password: The password for the specified account.
• Domain Name: Your fully qualified domain name (e.g., office.local).
• Organizational Unit (Optional): The specific OU path if you want to categorize these machines in AD.

5. Save and Apply

Click the Save button at the bottom of the dialog.

Results and Next Steps

On the next boot, any machine assigned to this image will automatically process these credentials and bind to your Active Directory.

Important Notes:

• Ensure your DNS settings on the client machines are correctly pointed to your Domain Controller.
• The machine will need a valid network path to the DC during the boot process to complete the join.
• Make sure your machine names observe NETBIOS naming conventions.

Updated on: 23/03/2026