{"id":18465945,"url":"https://github.com/j-isreal/x2go-docker","last_synced_at":"2026-03-14T15:35:04.832Z","repository":{"id":253923682,"uuid":"844944465","full_name":"j-isreal/x2go-docker","owner":"j-isreal","description":"Docker build and compose files for x2go server to use with remote access desktops","archived":false,"fork":false,"pushed_at":"2024-09-10T07:21:41.000Z","size":105,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-21T08:50:53.846Z","etag":null,"topics":["docker","ubuntu","x2go"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/j-isreal.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2024-08-20T09:21:09.000Z","updated_at":"2025-06-05T16:20:00.000Z","dependencies_parsed_at":"2024-09-10T09:10:53.399Z","dependency_job_id":null,"html_url":"https://github.com/j-isreal/x2go-docker","commit_stats":null,"previous_names":["j-isreal/x2go-docker"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/j-isreal/x2go-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j-isreal%2Fx2go-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j-isreal%2Fx2go-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j-isreal%2Fx2go-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j-isreal%2Fx2go-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/j-isreal","download_url":"https://codeload.github.com/j-isreal/x2go-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j-isreal%2Fx2go-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30508041,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-14T14:51:43.155Z","status":"ssl_error","status_checked_at":"2026-03-14T14:47:41.964Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","ubuntu","x2go"],"created_at":"2024-11-06T09:14:32.749Z","updated_at":"2026-03-14T15:35:04.810Z","avatar_url":"https://github.com/j-isreal.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# x2go-docker README.md\n\u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/badge/version-1.02.00-blue\" /\u003e\u003c/a\u003e \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/badge/docker-version_24.0.7-green\" /\u003e\u003c/a\u003e \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/badge/ubuntu-latest_24.04-orange\" /\u003e\u003c/a\u003e\n\n\u003chr /\u003e\n\n**Docker compose scripts and docker hub images which contain different Ubuntu Desktop setups for x2go remote access desktop\n**\n\nTo install docker, [https://docs.docker.com/engine/install/#server](https://docs.docker.com/engine/install/#server)\n\nCurrently, I have linux-based arm64 and amd64 images:\n\n- Ubuntu 24.04 (latest) with either:\n   - LXDE desktop\n   - XFCE4 desktop\n   - Mate desktop\n\n **Check out my development project page:** https://www.jinet.us/dev/dev-projects/x2go-docker/\n \u003cbr/\u003e\u003cbr /\u003e\n \n  \n## 1. Clone the git repo\nClone the git repo or [download the files](https://github.com/j-isreal/x2go-docker/archive/refs/heads/main.zip) so you can work with them.\n```\ngit clone https://github.com/j-isreal/x2go-docker.git\n```\n\n## 2. Create docker network FIRST\nCreate a macvlan docker network for the local lan FIRST - see [1-create-network.md](https://github.com/j-isreal/x2go-docker/blob/998f9714272729bfac3506e83e5495dc16be2e9e/1-create-network.md)\n\n\n### How to run on Docker ?\nYou can use my pre-built docker images or build one for your system architecture/setup using included Dockerfile.\n\nNOTE: It is \u003cu\u003ehighly recommended\u003c/u\u003e to use a pre-built Docker Hub image [by using the Docker compose method below\n](https://github.com/j-isreal/x2go-docker/blob/main/README.md#3-create-container-using-docker-compose).\n\n**Docker Hub images** - [use the docker compose method below](https://github.com/j-isreal/x2go-docker/blob/main/README.md#3-create-container-using-docker-compose):\n\n- [https://hub.docker.com/r/jisreal/docker-x2go-xfce4-arm64](https://hub.docker.com/r/jisreal/docker-x2go-xfce4-arm64)\n- [https://hub.docker.com/r/jisreal/docker-x2go-lxde-arm64](https://hub.docker.com/r/jisreal/docker-x2go-lxde-arm64)\n- [https://hub.docker.com/r/jisreal/docker-x2go-mate-arm64](https://hub.docker.com/r/jisreal/docker-x2go-mate-arm64)\n- [https://hub.docker.com/r/jisreal/docker-x2go-lxde-amd64](https://hub.docker.com/r/jisreal/docker-x2go-lxde-amd64)\n- [https://hub.docker.com/r/jisreal/docker-x2go-xfce4-amd64](https://hub.docker.com/r/jisreal/docker-x2go-xfce4-amd64)\n- [https://hub.docker.com/r/jisreal/docker-x2go-mate-amd64](https://hub.docker.com/r/jisreal/docker-x2go-mate-amd64)\n\n\nTo build for your architecture/system - NOT SUGGESTED:\n\n```\n(go to folder you git cloned)\ncd [lxde or xfce4 or mate]  # your choice of desktop\ndocker build -t [yourimagename] . # don't forget the trailing period\n```\n\n## 3. Create Container using Docker Compose\nAfter you either choose to use a pre-built Docker Hub image or build an image, create your container using Docker Compose.\n\n\u003cb\u003eDon't forget to edit the appropriate docker-compose file\u003c/b\u003e to specify the correct image and IP address.  \n\nSee the README.md file in either the lxde or xfce4 folder first to make the changes.\n\n```\n(go to folder you git cloned)\ncd [lxde or xfce4 or mate]  # your choice of desktop\ndocker compose -f docker-compose-lxde.yml up -d  # or -r docker-compose-xfce4.yml, your choice\n\n** note down the root/dockerx passwords\n```\nThe initial passwords will be displayed if you omit the -d above.  It's recommended to change the passwords immediately, for security.\n\n\n## 4. Connect to x2go server with client\n\nDownload the x2go client for your OS from:\n[http://wiki.x2go.org/doku.php/doc:installation:x2goclient](http://wiki.x2go.org/doku.php/doc:installation:x2goclient)\n\n### Connect to your server with \n\nHost : (Your Server IP)\n\nPort : 22\n\nUsername : dockerx \n\nPassword : (varies or could be just 'changeme')\n\n\nSelect the Session TYPE as : XFCE or LXDE or MATE depending on your setup.\n\nYou can also SSH to the docker container directly with root or dockerx users and their passwords over the port 22 with linux ssh or windows putty clients.\n\nUser dockerx can be used to login; however, for some reason you need to use root for your very first login - then you can use dockerx to login with x2go :)\n\n```\nssh root@dockerhost -p 22\n```\n\n## Persistent Disk Volume\nThe docker compose file sets up a disk storage volume called \"x2go_homes\" and is mounted inside the x2go server at \"/home\" - the user home folders location.\n\nThis volume will be located on the host machine at \"/var/lib/docker/volumes/x2go_homes/_data\" so you can make backups or perform file operations there.\n\n\n## Why this project?\n\nI wanted to expand on the original project and images that were created over a decade ago by [https://github.com/paimpozhil/](paimpozhil) to include the latest version of Ubuntu (including arm64 for my Raspberry Pi 4b) and the 2 lightweight desktops, XFCE4 and LXDE, via X2go.  Also created /home storage volume on host so it can be backed up from the docker host, updated network to use the local network for easy access, and created docker compose files for both desktop versions.\n\nThis system also works as a VERY cheap remote-desktop for anyone who wants a desktop on the cloud for anything from working remotely or browse internet where there are VPN restrictions.\n\nYou can run 2-3 desktops over a cheap DigitalOcean VPS.  I run this on my Raspberry Pi (which has 8GB RAM) and can get several users logged in at the same time.\n\n\n## Need support?\n\n#### http://dockerteam.com\n\n### Credits:\n\n- https://github.com/paimpozhil/DockerX2go\n- http://bmullan.wordpress.com/\n- https://github.com/rogaha/docker-desktop\n- https://github.com/tutumcloud/tutum-ubuntu\n\n- Docker.io and x2go.org\n\n**Check out my development project page:** https://www.jinet.us/dev/dev-projects/x2go-docker/\n\nCopyright \u0026copy; 2024 Jacob Eiler, Isreal Consulting, LLC.  All rights reserved.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj-isreal%2Fx2go-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fj-isreal%2Fx2go-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj-isreal%2Fx2go-docker/lists"}