BytesOfProgress

Wiki


Installing Apache Guacamole

Apache Guacamole is an open-source remote desktop gateway that allows users to access their desktop environments via a web browser. It is designed to be clientless, meaning it requires no software to be installed on the client side. The user is easily able to access all of their computers remotely through a webbrowser!

We are going to install guacamole using this docker image.

Setting it up

This method is tested on Debian 12.

Necessary preparations: A Debian or Debian-based server, root access.

First we need to install docker and docker-compose:


  # apt install docker.io docker-compose -y
    

After that we need to create a file called "docker-compose.yml".


  # touch docker-compose.yml
    

Now we need to paste following contents into the file:

NOTE: YAML is indentation-sensitive!

version: "3"
services:
  guacamole:
    image: abesnier/guacamole
    container_name: guacamole

    volumes:
      - postgres:/config

    ports:
      - 8080:8080

    restart: always

volumes:
  postgres:
    driver: local

Now we can start the containers like this:


  # docker-compose up -d
    

We can now access Apache Guacamole with our webbrowser: "http://IP_ADDRESS:8080/".

Default Login:

User: guacadmin

Pass: guacadmin

Please make sure to change the login name and password as soon as possible.




back