{"id":17498397,"url":"https://github.com/pothos/phosh-vnc","last_synced_at":"2025-09-06T17:45:25.998Z","repository":{"id":142163473,"uuid":"545143825","full_name":"pothos/phosh-vnc","owner":"pothos","description":"GNOME Phosh user session in a container accessible via VNC","archived":false,"fork":false,"pushed_at":"2022-10-04T21:26:03.000Z","size":10,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-04T21:46:11.023Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/pothos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2022-10-03T21:27:36.000Z","updated_at":"2025-04-18T18:05:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"9baa8cf4-7da9-4098-b376-7f8581336bd7","html_url":"https://github.com/pothos/phosh-vnc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pothos/phosh-vnc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pothos%2Fphosh-vnc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pothos%2Fphosh-vnc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pothos%2Fphosh-vnc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pothos%2Fphosh-vnc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pothos","download_url":"https://codeload.github.com/pothos/phosh-vnc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pothos%2Fphosh-vnc/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264502621,"owners_count":23618658,"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","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":[],"created_at":"2024-10-19T16:56:03.048Z","updated_at":"2025-07-09T20:06:29.337Z","avatar_url":"https://github.com/pothos.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Phosh Container with VNC Server\n\nA graphical GNOME Phosh user session in a container, accessible via VNC and using software rendering.\nThis works thanks to [wayvnc](https://github.com/any1/wayvnc) for wlroots.\n\nNote that GNOME Shell also has desktop sharing via RDP and VNC but here Phosh is used due to it being a bit more lightweight.\n\n## Usage\n\nFrom the prebuilt image:\n\n```\npodman run --systemd=always --rm -p 7050:7050 ghcr.io/pothos/phosh-vnc:main\n```\n\nFrom a locally built image:\n\n```\nmake\npodman run --systemd=always --rm -p 7050:7050 phosh-vnc\n```\n\nTest it out with `vinagre -f vnc://127.0.0.1:7050` and stop the container with Ctrl-C on the command line or from within the container through a `sudo poweroff`.\n\nThe user account `user` has no password set and you have sudo access without a password from it.\n\nWith Docker things are a bit more complicated, you can try one of:\n\n```\ndocker run --rm --privileged --cgroupns=host --tmpfs /tmp --tmpfs /run --tmpfs /run/lock -v /sys/fs/cgroup:/sys/fs/cgroup -p 7050:7050 phosh-vnc\n# or\ndocker run --rm --privileged --cgroup-parent=docker.slice --cgroupns private --tmpfs /tmp --tmpfs /run --tmpfs /run/lock -p 7050:7050 phosh-vnc\n```\n\nHowever, this wasn't enough for me and Phosh failed to start for some reason.\n\n## Note\n\nIf you already have SSH access to a system with Phosh and wayvnc installed, you don't need to use the container.\nInstead, you can either directly create the file `/etc/systemd/system/phosh.service.d/10-headless.conf` as done in the container\nor you can start Phosh temporarily:\n\n```\n# start-vnc.sh\nset -euo pipefail\nexport LIBGL_ALWAYS_SOFTWARE=1 # You can skip this if you have a GPU present\nexport LD_LIBRARY_PATH=/usr/lib\nmkdir -p /tmp/.X11-unix\n[ -d \"/run/user/$UID\" ] || { sudo mkdir -p \"/run/user/$UID\" \u0026\u0026 sudo chown \"$USER:$USER\" \"/run/user/$UID\" ; }\nexport XDG_CURRENT_DESKTOP=GNOME XDG_SESSION_DESKTOP=phosh XDG_SESSION_TYPE=wayland \"XDG_RUNTIME_DIR=/run/user/$UID\"\ngsettings set sm.puri.phoc auto-maximize false\nkillall phoc || true\nWLR_BACKENDS=headless WLR_LIBINPUT_NO_DEVICES=1 phoc --exec \"bash -lc '/usr/libexec/phosh --unlocked \u0026 wayvnc -g 127.0.0.1 7050'\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpothos%2Fphosh-vnc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpothos%2Fphosh-vnc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpothos%2Fphosh-vnc/lists"}