How to Deploy Guacamole with Marketplace Apps

Updated , by Linode

Traducciones al Español
Estamos traduciendo nuestros guías y tutoriales al Español. Es posible que usted esté viendo una traducción generada automáticamente. Estamos trabajando con traductores profesionales para verificar las traducciones de nuestro sitio web. Este proyecto es un trabajo en curso.

Guacamole Marketplace App

Apache Guacamole is an open source HTML5-based web application used as a remote desktop gateway. With the Guacamole Marketplace App, you can access your Linode with a graphical VNC session using the XFCE desktop environment from any device. This Marketplace App installs and configures Guacamole on a Linode, complete with an SSL certificate generated by Certbot for your domain.

Deploy a Guacamole Marketplace App

Linode’s App Marketplace allows you to easily deploy software on a Linode using the Linode Cloud Manager. To access Linode’s App Marketplace:

  1. Log in to your Linode Cloud Manager account.

  2. From the Linode dashboard, click on the Marketplace button in the left-hand navigation menu.

  3. The Linode creation page appears, with the Marketplace tab pre-selected.

  4. Under the Select App section, select the app you would like to deploy:

    Select a Marketplace App to deploy

  5. Once you have selected the app, proceed to the app’s Options section and provide values for the required fields.

The Guacamole Options section of this guide provides details on all available configuration options for this app.

Guacamole Options

You can configure your Guacamole App by providing values for the following fields:

FieldDescription
The limited sudo/VNC user to be created for the LinodeThe VNC username created for this Linode with sudo permissions. This is used for your VNC session. Required.
The password for the limited sudo/VNC userPassword for your sudo/VNC user. This is used for your VNC session. Required.
The username to be used with GuacamoleYour Guacamole Username. This is used to log in to Guacamole. Required.
The password to be used with GuacamoleYour Guacamole Password. This is used to log in to Guacamole. Required
Your Linode API TokenYour Linode API Token is needed to create DNS records. If this is provided along with the Subdomain and Domain fields, the installation attempts to create DNS records via the Linode API. If you don’t have a token, but you want the installation to create DNS records, you must create a token to use in this field before continuing.
SubdomainThe subdomain you wish the installer to create a DNS record for during setup. The suggestion given is www. The subdomain can only be created if you also provide a Domain and API Token.
DomainThe domain name where you wish to host your Guacamole server. The installer creates a DNS record for this domain during setup if you provide this field along with the required API Token.
Admin EmailThe email address to register with Certbot when generating an SSL certificate for your absolute domain. This field is required along with your API Token and Domain for HTTPS access to your Guacamole remote desktop.

Linode Options

After providing the App-specific options, provide configurations for your Linode server:

ConfigurationDescription
Select an ImageDebian 10 is currently the only image supported by the Guacamole Marketplace App, and it is pre-selected on the Linode creation page. Required.
RegionThe region where you would like your Linode to reside. In general, it’s best to choose a location that’s closest to you. For more information on choosing a DC, review the How to Choose a Data Center guide. You can also generate MTR reports for a deeper look at the network routes between you and each of our data centers. Required.
Linode PlanYour Linode’s hardware resources. Guacamole can be supported on any size Linode, but we suggest you deploy your Guacamole App on a Linode plan that reflects how you plan on using it. If you decide that you need more or fewer hardware resources after you deploy your app, you can always resize your Linode to a different plan. Required.
Linode LabelThe name for your Linode, which must be unique between all of the Linodes on your account. This name is how you identify your server in the Cloud Manager Dashboard. Required.
Root PasswordThe primary administrative password for your Linode instance. This password must be provided when you log in to your Linode via SSH. The password must meet the complexity strength validation requirements for a strong password. Your root password can be used to perform any action on your server, so make it long, complex, and unique. Required.

After providing all required Linode Options, click on the Create button. Your Guacamole App will complete installation anywhere between 5-20 minutes after your Linode has finished provisioning.

Getting Started after Deployment

Access your Guacamole App

After Guacamole has finished installing, access the dashboard over http:// or https:// with your Linode’s IPv4 address or absolute domain name, depending on your setup choices.

  1. If you set up a domain name for your Guacamole App during setup, skip to step 3.

  2. If you didn’t set up a domain name, find your Linode’s IPv4 address by clicking on Linodes in the Cloud Manager sidebar to see a list of all your Linodes. Find the Linode you just created. Under the IP Address column, copy the IPv4 address.

  3. Enter your Linode’s absolute domain or IPv4 address into a browser window (for example, http://192.0.2.0) to access the Guacamole login page. Enter your Guacamole username and password.

    View the Guacamole login page.

Note
The Guacamole login page may take several minutes to become available while the Application completes the creation process.
  1. Once you’ve completed the login process, you have full access to your Linode from your Guacamole remote desktop using VNC and the XFCE desktop environment.

    The Guacamole remote desktop provides access to your Linode through a web browser.

  2. Additional tasks can be performed remotely through your web browser. For example, you can install the Firefox web browser for use with your Guacamole remote desktop by entering the following command in its Terminal Emulator:

     sudo apt install firefox-esr
    

    When prompted, enter the password you chose for the limited sudo/VNC user. You can now browse the web on your Guacamole browser from within your local browser.

Note
Currently, Linode does not manage software and systems updates for Marketplace Apps. It is up to the user to perform routine maintenance on software deployed in this fashion.

More Information

You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.

This page was originally published on

Try this guide to receive $100 at signup on a new account.

Your Feedback Is Important

Let us know if this guide made it easy to get the answer you needed.