SPICE | Guacamole Admin Guide - UMCST/SPICE-user-info GitHub Wiki

Basic User & connection management on Guacamole

Type of Systems: Guacamole Server

Necessary Skills: None

Complete Goal: Add users, connections, and read-only connections to Guacamole

Pre-Req: Have an admin session on a Guacamole instance.


Add connections:

  1. Open First, add a connection group to put the connections in by clicking on the username in the top left, going to Settings, then clicking on “Connections”
  2. Add a new organizational connection group (not a load balancing group)
  3. For the first connection, hit “New connection” on the connections page
    • Fill in info for the connection, including name, connection type, IP/Hostname, username, password, and connection groups
    • For “Guacamole Proxy Parameters”, set hostname to “guacd”, port to “4822”, and encryption to “none”.
    • Click save.
  4. For each additional connection of the same type, click on an existing connection to open the edit page, scroll to the bottom and click clone.
    • Change the name and IP/Hostname
    • Hit “Save” at the bottom of the page

Add a Users:

  1. For the first user:
    • Under Settings->Users, click “New User”
    • Fill in Username, Name, and Password
    • At the bottom of the page, select the connection folder and desired connections (easiest to just select all connections in the group)
    • Hit save
  2. For additional users, enter the edit page for an existing user and hit “Clone” at the bottom, change the name, set the password, and make sure they’re assigned to the right connection(s)

Read-only connection:

  1. Go into the edit page for the connection you want read-only access to, and hit “Clone”
  2. Set the name for the new connection, put it in a different group if desired, and check the “readonly” box half-way down the page
⚠️ **GitHub.com Fallback** ⚠️