christopher-kapic / caprover-guacamole

Instructions for running Guacamole with CapRover
Apache License 2.0
5 stars 0 forks source link
caprover guacamole

How to run Guacamole on CapRover

If you do not know about Guacamole or CapRover, check them out:

Website

Website

Process

  1. Set up CapRover - The simplest way to do this is with DigitalOcean; if you'd like, you can use my affiliate link: DigitalOcean Referral Badge
  2. Use the one-click-app - In your CapRover instance, go to Apps > One-Click Apps/Databases > Guacamole. Enter your app name (probably guacamole) and database password. Deploy the app.
  3. Enable https and websocket support in the guacamole dashboard (in CapRover). You may want to also enable force https.
  4. Set up the database - Guacamole does not automatically configure the database (unlike many other One-Click Apps, which do). You will need to connect to your MySQL database to run two SQL scripts. I suggest you create another One-Click App, adminer. In Adminer (after it is deployed), or whichever SQL client you choose to use, connect to the guacamole database (username: guacamole, database: guacamole, server: srv-captain--${appname}-db) and find the SQL Command dashboard. Copy and paste and execute each of these scripts:
  5. Give guacamole a moment, and then it should be ready. You can access guacamole by going to the domain assigned to it with /guacamole on the end (eg: https://${appname}.yourdomain.com/guacamole). The default username is guacadmin and the default password is also guacadmin. I recommend changing it once you log in.
  6. (Optional) Remove adminer from your CapRover instance.

If this was helpful, consider following me on Github or giving this repository a star. Thank you.