Introduction:
Apache Guacamole is an open-source remote desktop gateway that allows you to access your computer desktop from anywhere using just a web browser. It provides a convenient and secure way to connect to remote systems. In this guide, we will walk you through the installation of Apache Guacamole using Docker on an Ubuntu 22.04 server.
Prerequisites:
Before you begin, make sure you have the following:
- A Ubuntu 22.04 server with a user account with sudo privileges.
- Docker installed on your Ubuntu server. If Docker is not installed, you can follow this guide to set it up.
Step 1: Update the System:
First, log in to your Ubuntu 22.04 server and update the package list to ensure you have the latest information:
sudo apt update
Step 2: Install Docker Compose:
Docker Compose is a tool for defining and running multi-container Docker applications. Install Docker Compose using the following commands:
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
Step 3: Create a Docker Compose File:
Create a directory to store your Guacamole configuration files:
mkdir ~/guacamole
cd ~/guacamole
Now, create a docker-compose.yml
file for Apache Guacamole:
version: '3'
services:
guacamole:
image: guacamole/guacamole:latest
container_name: guacamole
restart: always
environment:
- GUACD_HOSTNAME=guacd
- GUACD_PORT=4822
- MYSQL_HOSTNAME=mysql
- MYSQL_PORT=3306
- MYSQL_DATABASE=guacamole_db
- MYSQL_USER=guacamole_user
- MYSQL_PASSWORD=your-password
ports:
- 8080:8080
guacd:
image: guacamole/guacd:latest
container_name: guacd
restart: always
ports:
- 4822:4822
mysql:
image: mysql:latest
container_name: guacamole-mysql
restart: always
environment:
- MYSQL_ROOT_PASSWORD=your-root-password
- MYSQL_DATABASE=guacamole_db
- MYSQL_USER=guacamole_user
- MYSQL_PASSWORD=your-password
Replace your-password
and your-root-password
with your desired passwords.
Step 4: Start Guacamole Containers:
Start the Guacamole containers using Docker Compose:
docker-compose up -d
Step 5: Access Apache Guacamole:
Once the containers are up and running, you can access Apache Guacamole by opening a web browser and navigating to:
http://your-server-ip:8080/guacamole/
Log in using the default credentials:
- Username: guacadmin
- Password: guacadmin
Step 6: Configure Remote Connections:
Apache Guacamole allows you to configure remote connections to your machines. You can add and manage connections through the web interface.
Conclusion:
You have successfully installed Apache Guacamole via Docker on your Ubuntu 22.04 server. You can now use this web-based remote desktop gateway to connect to your remote systems securely. Customize and add connections as needed to make the most of this powerful tool for remote access.