{"id":29792583,"url":"https://github.com/josel82/guacamole-deployment-guide","last_synced_at":"2026-04-13T03:36:53.020Z","repository":{"id":299071755,"uuid":"1001713903","full_name":"josel82/guacamole-deployment-guide","owner":"josel82","description":"Guacamole with Tailscale integration","archived":false,"fork":false,"pushed_at":"2025-07-27T22:09:33.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-27T23:25:30.903Z","etag":null,"topics":["docker","docker-compose","guacamole","linux","tailscale"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/josel82.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-13T21:49:37.000Z","updated_at":"2025-07-27T22:09:36.000Z","dependencies_parsed_at":"2025-06-14T14:25:23.887Z","dependency_job_id":"30a6bc52-35b0-4e24-aafe-37adc20dc35c","html_url":"https://github.com/josel82/guacamole-deployment-guide","commit_stats":null,"previous_names":["josel82/guacamole-deployment-guide"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/josel82/guacamole-deployment-guide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josel82%2Fguacamole-deployment-guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josel82%2Fguacamole-deployment-guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josel82%2Fguacamole-deployment-guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josel82%2Fguacamole-deployment-guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/josel82","download_url":"https://codeload.github.com/josel82/guacamole-deployment-guide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josel82%2Fguacamole-deployment-guide/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267451492,"owners_count":24089312,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-28T02:00:09.689Z","response_time":68,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-compose","guacamole","linux","tailscale"],"created_at":"2025-07-28T02:00:37.138Z","updated_at":"2026-04-13T03:36:47.989Z","avatar_url":"https://github.com/josel82.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Apache Guacamole Deployment Guide\nCredits to:\n- [Sonoran Tech](https://www.youtube.com/watch?v=PEUO2cCICS4)\n- [Alex from Tailscale](https://www.youtube.com/watch?v=YTjYXii4WzI\u0026t=514s)\n\nThe following steps walk you through setting up Guacamole with docker compose. Instructions on how to integrate Tailscale with this project in `guacamole-tailscale` directory.\n\n## Requirements\nThis deployment requires Docker Engine and Docker Compose installed on the host server.\nFor installation instructions, visit the official [Docker documentation](https://docs.docker.com/engine/install/).\nOr visit [get.docker.com](https://get.docker.com/) and download their Docker install script\n\n## Deployment Steps\n1. Clone this Repository\n```bash\ngit clone https://github.com/josel82/guacamole-deployment-guide.git\ncd guacamole-deployment-guide/guacamole\n```\n**Note:** Tailscale integration on `guacamole-deployment-guide/guacamole-tailscale`\n\n2. Configure Environment\nEdit the `docker-compose.yml` file and replace the default database user and root passwords with secure credentials.\n\n3. Launch the Containers\nRun the following command:\n```bash\ndocker compose up -d\n```\nAlternatively, you can deploy the stack via Portainer, if installed.\n\nOnce the containers are running, proceed to initialize the database.\n\n## MySQL Database Setup\n1. Access the Database Container\nFrom the host server:\n```bash\ndocker exec -it guac-sql /bin/bash\n```\nOr use Portainer to access the terminal.\n\nThen start the MySQL CLI:\n```bash\nmysql -u root -p\n```\nEnter the root password when prompted.\n\n2. Create the Database\n```sql\nCREATE DATABASE guacamole_db;\n```\n\n3. Create the Database User\n\n```sql\nCREATE USER 'guacamole_user'@'%' IDENTIFIED BY 'your_secure_password';\nGRANT SELECT, INSERT, UPDATE, DELETE ON guacamole_db.* TO 'guacamole_user'@'%';\nFLUSH PRIVILEGES;\n```\n\nOptional: Verify the user creation\n\n\n```sql\nSELECT User FROM mysql.user;\n```\nLeave this terminal open — you'll return to it shortly.\n\n4. Initialize the Guacamole Schema\nOn the host machine, generate the initialization SQL:\n```bash\ndocker run --rm guacamole/guacamole /opt/guacamole/bin/initdb.sh --mysql \u003e initdb.sql\n```\nCopy the file to the guac-sql container:\n```bash\ndocker cp ./initdb.sql guac-sql:/initdb.sql\n```\nReturn to the MySQL shell inside the container and run:\n\n```sql\nUSE guacamole_db;\nSOURCE initdb.sql;\n```\n\n## Accessing Guacamole\nOnce setup is complete, open your browser and navigate to:\n`http://\u003cyour-server-ip\u003e:8080/guacamole`\nYou should now see the Guacamole login interface.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosel82%2Fguacamole-deployment-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjosel82%2Fguacamole-deployment-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosel82%2Fguacamole-deployment-guide/lists"}