https://github.com/arulrajnet/guacamole-compose
Guacamole with RDP and SSH connections
https://github.com/arulrajnet/guacamole-compose
docker-compose guacamole nginx
Last synced: 2 months ago
JSON representation
Guacamole with RDP and SSH connections
- Host: GitHub
- URL: https://github.com/arulrajnet/guacamole-compose
- Owner: arulrajnet
- License: mit
- Created: 2021-09-12T13:11:09.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2026-01-20T04:56:07.000Z (6 months ago)
- Last Synced: 2026-01-20T12:02:26.600Z (6 months ago)
- Topics: docker-compose, guacamole, nginx
- Language: Shell
- Homepage:
- Size: 97.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Guacamole + Nginx + RDP & SSH Connections
## Table of Contents
- [Guacamole + Nginx + RDP \& SSH Connections](#guacamole--nginx--rdp--ssh-connections)
- [Table of Contents](#table-of-contents)
- [Overview](#overview)
- [Prerequisites](#prerequisites)
- [How to Use](#how-to-use)
- [Architecture](#architecture)
- [Version Information](#version-information)
- [Previous Releases](#previous-releases)
- [Key Features](#key-features)
- [Author](#author)
## Overview
This is a Docker Compose stack that includes:
* Guacamole with MySQL as a datasource
* Nginx as a reverse proxy
* Automatically adds example SSH and RDP connections
## Prerequisites
* Docker 19.03.13 or latest
* Docker compose 1.29.2 or latest
## How to Use
### Start Guacamole
To start Guacamole without the test devices (openssh, rdesktop):
```bash
docker compose up -d
```
### Start Guacamole with Test Devices
To start Guacamole along with `openssh` and `rdesktop` containers for testing:
```bash
docker compose --profile devices up -d
```
### Validation
1. **Access Guacamole**: Open your browser and navigate to `http://localhost:8080/`.
2. **Login**: Use default credentials:
- Username: `guacadmin`
- Password: `guacadmin`
3. **Verify Connections**:
- You should see `openssh-ssh` and `rdesktop-rdp` connections if you started with the `devices` profile.
- Click on them to verify connectivity.
4. **Verify SFTP**:
- The connections remain configured with SFTP support enabled.
## Architecture
Refer to the [Guacamole documentation](https://guacamole.apache.org/doc/gug/guacamole-architecture.html) for more details.
## Version Information
The following versions are used in this setup:
* Guacamole 1.6.0
* MySQL 8.0.26
* Nginx 1.21.1
## Previous Releases
- [v1.3.0](https://github.com/arulrajnet/guacamole-compose/releases/tag/v1.3.0)
- [v1.4.0](https://github.com/arulrajnet/guacamole-compose/releases/tag/v1.4.0)
- [v1.5.5](https://github.com/arulrajnet/guacamole-compose/releases/tag/v1.5.5)
## Key Features
The key features of this setup include:
* `db-init` exports the base schema into a Docker volume
* MySQL uses that Docker volume for database initialization
* The Guacamole container starts up once MySQL and guacd become healthy
* The Guacamole init container adds SSH and RDP connections within the same Docker network
## Author
Arul
