> ## 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). # Installing or Updating the ggLeap Client on a ggRock Machine ## Installing or Updating the ggLeap Client on a ggRock Machine This article describes steps necessary to install or update the ggLeap client on a ggRock Machine. ### General Outline * Enable Keep Writebacks for the Machine on which you would like to install the ggLeap Client * Turn On the Machine from which you would like to apply changes * Install the ggLeap Client * Observe a reboot that occurs after the ggLeap Client installation completes * Set a name for the Machine in ggLeap when prompted * Shut down the Machine * Disable Keep Writebacks for the Machine * Apply Writebacks * Reboot all systems to ensure the changes propagate to them, setting names on each when prompted. ### Pre-Installation Setup 1. Enable "**Keep Writebacks**" in the Settings of the Machine. (See the [**Machines Administration Manual**](https://helpdesk.ggcircuit.com/en/article/ggrock-machines-1xbl2d2/)for more information). **NOTE:** *This is a required step because the ggLeap Client installation requires a reboot - without "**Keep Writebacks**" enabled the changes will be lost on reboot* ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195044.png?version=1&modificationDate=1747425047995&cacheVersion=1&api=v2) 2. Turn on the Machine. In this example we use the "**Wake on LAN"** functionality of ggRock, however you may elect to press the power button physically on the Machine. ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195105.png?version=1&modificationDate=1747425068612&cacheVersion=1&api=v2) ### ggLeap Client Installation 3. Download the ggLeap Client. For more information, please refer to "[**How to Download the ggLeap Client**](https://helpdesk.ggcircuit.com/en/article/how-to-download-the-ggleap-client-1xrpl2/)". 4. Install the ggLeap Client. Locate the downloaded installation file and double-click it to begin installation. ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195127.png?version=1&modificationDate=1747425090946&cacheVersion=1&api=v2) 5. If a UAC prompt appears, click the "**Yes**" button to continue. ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195143.png?version=1&modificationDate=1747425107338&cacheVersion=1&api=v2) 6. From the "**Welcome to ggLeap Setup**" screen, click the "**Install**" button. ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195202.png?version=1&modificationDate=1747425126036&cacheVersion=1&api=v2) 7. Observe the installation process. ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195224.png?version=1&modificationDate=1747425148912&cacheVersion=1&api=v2) 8. From the "**Installation Complete**" screen, click the "**Next >**" button. ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195244.png?version=1&modificationDate=1747425168018&cacheVersion=1&api=v2) 9. From the "**Completing ggLeap Setup**" screen, click the "**Finish**" button. ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195300.png?version=1&modificationDate=1747425184196&cacheVersion=1&api=v2) 10. Observe the installation of the Microsoft Edge Webview2 Runtime (if required). ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195318.png?version=1&modificationDate=1747425201055&cacheVersion=1&api=v2) 11. From the "**Admin login**" screen, enter your ggLeap administrator account credentials. ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195337.png?version=1&modificationDate=1747425221112&cacheVersion=1&api=v2) 12. Observe the initialization process of the ggLeap Client. ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195105.png?version=1&modificationDate=1747425068612&cacheVersion=1&api=v2) 13. From the "**PC name setup**" screen, enter a name for this ggRock Machine in the "**PC name**" text box. **NOTE:** *This is the name that you will see in the ggLeap Web Admin to perform administrative tasks on this Machine. Each Machine must have a unique name in the ggLeap Web Admin. This name can be changed at a later time.* ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195105.png?version=1&modificationDate=1747425068612&cacheVersion=1&api=v2) 14. When prompted to permit the system to reboot into shell mode, click the "**OK**" button. **NOTE:** *It is important at this phase to ensure that "**Keep Writebacks**" is enabled for the Machine in question. For more information, please refer to the* [***Machines Manual***](https://app.crisp.chat/website/574ccbdb-fedc-4721-8ca2-1639892b6db8/helpdesk/articles/en/010af600-3146-454a-bcf6-e79f98063077/)*.* ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195105.png?version=1&modificationDate=1747425068612&cacheVersion=1&api=v2) 15. After the Machine reboots, observe additional automated post-reboot setup ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195105.png?version=1&modificationDate=1747425068612&cacheVersion=1&api=v2) 16. Observe the ggLeap login screen. ### Final Steps 17. Shut Down the Machine. In this case, we utilize the "**Shut down**" Power command within the ggLeap Web Admin, however you may utilize the power button or the ggRock "**Turn Off**" command as well. ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195105.png?version=1&modificationDate=1747425068612&cacheVersion=1&api=v2) 18. Disable "**Keep Writebacks**" in the Settings of the Machine. (See the [**Machines Administration Manual**](https://app.crisp.chat/website/574ccbdb-fedc-4721-8ca2-1639892b6db8/helpdesk/articles/en/8a40d68f-333a-4533-9f97-83ff258e3415/) for more information). ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195105.png?version=1&modificationDate=1747425068612&cacheVersion=1&api=v2) 19. Apply Writebacks. (See [**Applying Writebacks**](https://helpdesk.ggcircuit.com/en/article/how-writebacks-and-snapshots-work-in-ggrock-v6on7/) for more information). ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195105.png?version=1&modificationDate=1747425068612&cacheVersion=1&api=v2) Enter a comment when prompted (typically initials of the administrator, the date, and the contents (e.g. games, applications updated). **Example:** *ABC - 07-14-2021 - Updated Fortnite, COD:MW (launched to install shaders), and Google Chrome* ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15863141/image-20250516-195105.png?version=1&modificationDate=1747425068612&cacheVersion=1&api=v2) 20. Boot up all machines in the center, repeating [**steps 11-13**](https://help.ggcircuit.com/knowledge/how-writebacks-and-snapshots-work) for each in order to set a PC name. ### **Additional Information** * Ensure "**Keep Writebacks**" is enabled prior to rebooting so that your changes are not discarded. * If changes have been made and committed from a separate Machine while you were working on this one, it will not be possible to apply writebacks. Please coordinate with other administrators at your center when updating games and applications. * See "[**How Writebacks and Snapshots Work**](https://helpdesk.ggcircuit.com/en/article/how-writebacks-and-snapshots-work-in-ggrock-v6on7/)" for more information * Upon installing the ggLeap client to a ggRock Machine, the system reboots and after the reboot the ggLeap client is no longer installed (the system state is is reverted).