Guacd Setup Guide

Introduction

Guacamole's guacd is the Guacamole proxy daemon. It serves as the core of the Guacamole remote desktop gateway, handling all the protocol-specific aspects of connecting to remote desktops.

Prerequisites

• Docker installed
• Guacd container running in your Docker stack

Configuration Steps

Step 1: Accessing the Guacamole UI

1. Ensure you have the Guacamole web application container running alongside guacd.
2. Open your browser and navigate to http://<your-ip-address>:8080/guacamole.
3. Log in with your Guacamole credentials.

Step 2: Verifying Guacd Connection

1. Go to the Settings tab in the Guacamole UI.
2. Navigate to Connections.
3. Ensure that the guacd hostname and port (default 4822) are correctly configured.
4. Test the connection to verify that guacd is running and accessible.

Step 3: Adding Remote Desktop Connections

1. Navigate to the Connections tab.
2. Click New Connection.
3. Configure the connection settings:
   • Name: Give your connection a meaningful name.
   • Protocol: Choose the protocol (VNC, RDP, SSH).
   • Parameters: Enter the necessary parameters (hostname, port, username, password).
4. Click Save.

Step 4: Configuring Users and Permissions

1. Go to the Users tab.
2. Add new users or edit existing ones.
3. Assign connections to users and configure their permissions.
4. Click Save.

Step 5: Customizing Settings

1. Navigate to the Settings tab.
2. Customize global settings according to your preferences (e.g., theme, language).
3. Click Save.

Notes

• Ensure all paths and environment variables are updated in the guacd.yaml file.
• Regularly backup your config directory to save your settings.

Troubleshooting

• Common Issues: List common issues and solutions.
• Logs: Check Guacd logs for error messages.
• Support: Link to the Guacamole community and support resources.