Add Apache Guacamole (#6364)

This commit is contained in:
Nathan Fretz authored and GitHub committed 2026-11-13 14:34:10 +10:00
1 parent 82fef5d31d
commit 41d1c5f34f
5 files changed
+112

No files matched your search

View File
Whitespace-only changes.
@@ -0,0 +1,15 @@
-- Runs once, when the database is first created. The schema (generated by the
-- init service as 001-schema.sql) creates guacadmin with the well-known
-- password "guacadmin". Replace it with the per-install Umbrel app password.
-- Guacamole stores SHA-256(password || uppercase hex salt).
\getenv guacadmin_password GUACADMIN_PASSWORD
UPDATE guacamole_user AS u
SET password_salt = s.salt,
password_hash = sha256(convert_to(:'guacadmin_password' || upper(encode(s.salt, 'hex')), 'UTF8')),
password_date = CURRENT_TIMESTAMP
FROM guacamole_entity AS e,
(SELECT sha256(gen_random_uuid()::text::bytea) AS salt) AS s
WHERE u.entity_id = e.entity_id
AND e.name = 'guacadmin'
AND e.type = 'USER';
+51
View File
@@ -0,0 +1,51 @@
services:
app_proxy:
environment:
APP_HOST: guacamole_web_1
APP_PORT: 8080
web:
image: guacamole/guacamole:1.6.0@sha256:f344085e618bb05e22b964b0208dbd06d3468275bac70206f93805245e067b40
restart: on-failure
depends_on:
- guacd
- postgres
environment:
WEBAPP_CONTEXT: ROOT
GUACD_HOSTNAME: guacd
POSTGRESQL_HOSTNAME: postgres
POSTGRESQL_DATABASE: guacamole
POSTGRESQL_USERNAME: guacamole
POSTGRESQL_PASSWORD: ${APP_GUACAMOLE_DB_PASSWORD}
# umbrelOS proxies every client from the same address, so failed logins
# from anyone would lock everyone out. Umbrel auth already guards the app.
BAN_ENABLED: "false"
guacd:
image: guacamole/guacd:1.6.0@sha256:8974eaa9ba32f713daf311e7cc8cd7e4cdfba1edea39eed75524e78ef4b08f4f
restart: on-failure
# Writes Guacamole's database schema for Postgres to run on first start.
# Postgres only reads it while creating an empty database.
db-init:
image: guacamole/guacamole:1.6.0@sha256:f344085e618bb05e22b964b0208dbd06d3468275bac70206f93805245e067b40
user: "1000:1000"
restart: on-failure
entrypoint: ["/bin/sh", "-c", "/opt/guacamole/bin/initdb.sh --postgresql > /initdb/001-schema.sql"]
volumes:
- ${APP_DATA_DIR}/data/initdb:/initdb
postgres:
image: postgres:18.7-alpine@sha256:75dcac3dfb1cd01ca3536910bbc84128759362f8b118bf8c55b38a94f68f3b73
restart: on-failure
depends_on:
db-init:
condition: service_completed_successfully
environment:
POSTGRES_DB: guacamole
POSTGRES_USER: guacamole
POSTGRES_PASSWORD: ${APP_GUACAMOLE_DB_PASSWORD}
GUACADMIN_PASSWORD: ${APP_PASSWORD}
volumes:
- ${APP_DATA_DIR}/data/db:/var/lib/postgresql
- ${APP_DATA_DIR}/data/initdb:/docker-entrypoint-initdb.d:ro
+1
View File
@@ -0,0 +1 @@
export APP_GUACAMOLE_DB_PASSWORD="$(derive_entropy "${app_entropy_identifier}-postgres-password")"
+45
View File
@@ -0,0 +1,45 @@
manifestVersion: 1
id: guacamole
storage:
dataRoot: data
environment:
- name: TOTP_ENABLED
services:
- web
default: "false"
options:
- "true"
note: >-
Select true to require two-factor authentication (TOTP) for every Guacamole account. Each user sets up an authenticator app the next time they log in.
category: networking
name: Apache Guacamole
version: "1.6.0"
tagline: Access your computers from anywhere using just a web browser
description: >-
🔑 Log in with the username "guacadmin" and the password shown in Umbrel. After logging in, open Settings to add your first connection and to create separate accounts for other people.
Apache Guacamole is a clientless remote desktop gateway. It supports standard protocols like VNC, RDP, SSH, and Telnet, so you can reach the desktops and terminals of the computers on your network from any web browser, with no plugins or client software to install.
Connections are saved on your Umbrel, so you can open them from any device. Guacamole also supports clipboard sharing, SFTP file transfer, connection sharing, and multiple users with their own permissions.
releaseNotes: ""
developer: The Apache Software Foundation
website: https://guacamole.apache.org/
dependencies: []
repo: https://github.com/apache/guacamole-client
support: https://guacamole.apache.org/support/
port: 8493
gallery:
- 1.webp
- 2.webp
- 3.webp
path: ""
defaultUsername: guacadmin
deterministicPassword: true
submitter: Umbrel
submission: https://github.com/getumbrel/umbrel-apps/pull/6364