{"id":39526323,"url":"https://github.com/xorilog/docker-telegram","last_synced_at":"2026-01-18T06:24:35.235Z","repository":{"id":30115739,"uuid":"33665621","full_name":"xorilog/docker-telegram","owner":"xorilog","description":"Dockerfile for a Telegram gui client","archived":false,"fork":false,"pushed_at":"2024-05-07T08:08:36.000Z","size":142,"stargazers_count":63,"open_issues_count":1,"forks_count":32,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-05-07T09:28:17.010Z","etag":null,"topics":["docker","docker-telegram","telegram"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/xorilog.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}},"created_at":"2015-04-09T11:39:19.000Z","updated_at":"2024-05-07T09:28:22.060Z","dependencies_parsed_at":"2024-05-07T09:28:21.478Z","dependency_job_id":"a9daa7a4-5f30-49e5-90dc-b22d200dbfff","html_url":"https://github.com/xorilog/docker-telegram","commit_stats":null,"previous_names":[],"tags_count":109,"template":false,"template_full_name":null,"purl":"pkg:github/xorilog/docker-telegram","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xorilog%2Fdocker-telegram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xorilog%2Fdocker-telegram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xorilog%2Fdocker-telegram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xorilog%2Fdocker-telegram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xorilog","download_url":"https://codeload.github.com/xorilog/docker-telegram/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xorilog%2Fdocker-telegram/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28531995,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"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-telegram","telegram"],"created_at":"2026-01-18T06:24:35.121Z","updated_at":"2026-01-18T06:24:35.219Z","avatar_url":"https://github.com/xorilog.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# docker-telegram\n\nA Docker image that start a fresh telegram client.\n\n[![Circle CI](https://circleci.com/gh/xorilog/docker-telegram.svg?style=shield)](https://circleci.com/gh/xorilog/docker-telegram)\n[![Image Layers](https://images.microbadger.com/badges/image/xorilog/telegram.svg)](https://microbadger.com/images/xorilog/telegram)\n\n## Usage\n\nTo spawn a new instance of Telegram:\n\n### Linux\n\n```shell\ndocker run --rm -it --name telegram \\\n       --hostname=$(hostname) \\\n       -e DISPLAY=unix$DISPLAY \\\n       -e PULSE_SERVER=unix:$XDG_RUNTIME_DIR/pulse/native \\\n       -v /tmp/.X11-unix:/tmp/.X11-unix \\\n       -v \"/home/$(whoami)/.Xauthority:/home/user/.Xauthority\" \\\n       -v $XDG_RUNTIME_DIR/pulse:$XDG_RUNTIME_DIR/pulse \\\n       -v /etc/localtime:/etc/localtime:ro \\\n       -v \u003cYour_storage_dir\u003e/.TelegramDesktop:/home/user/.local/share/TelegramDesktop/ \\\n       xorilog/telegram\n```\n\n### Mac Os\n\n\u003e Requires xquartz (`brew cask install xquartz` then reboot your computer \u0026 check in preferences\u003eSecurity : Authenticate \u0026 Allow connections checkboxes)\n\n```bash\nIP=$(ifconfig en0 | grep inet | awk '$1==\"inet\" {print $2}')\ndocker run --rm -it --name telegram \\\n       -e DISPLAY=$(xhost + $(hostname) \u003e /dev/null; echo $IP):0 \\\n       -v /etc/localtime:/etc/localtime:ro \\\n       -v \u003cYour_storage_dir\u003e/.TelegramDesktop:/home/user/.local/share/TelegramDesktop/ \\\n       xorilog/telegram\n```\n\n## systemd\n\n### Adding the service\n\n```bash\nsudo curl -o /etc/systemd/system/telegram@.service \"https://raw.githubusercontent.com/xorilog/docker-telegram/master/telegram%40.service\"\nsudo systemctl daemon-reload\n```\n\n### Adding custom parameters\n\n* Add a file: `/etc/systemd/system/telegram@.service.d/proxy.conf` and replace the `\u003cvalue\u003e` with your parameters\n\n```bash\n[Service]\nEnvironment=\"http_proxy=http://\u003cproxy_name\u003e:\u003cproxy_port\u003e\"\nEnvironment=\"https_proxy=http://\u003cproxy_name\u003e:\u003cproxy_port\u003e\"\nEnvironment=\"no_proxy=localhost,.lxd\"\nEnvironment=DNS=\u003cDNS_IP\u003e\n```\n\n* reload systemd `sudo systemctl daemon-reload`\n* restart your service `sudo systemctl restart telegram@\u003cyour_username\u003e.service`\n\n### Activating for a user\n\n```bash\nsudo systemctl enable telegram@\u003cyour_username\u003e.service\nsudo systemctl start telegram@\u003cyour_username\u003e.service\n```\n\n## Issues\n\n* You have to log out Telegram to close the docker container.\n* You have to create your storage directory before start using `mkdir \u003cYour_storage_dir\u003e` as the one created by docker is owned by root user.\n\n## FAQ\n\n### Docker image registry\n\nImages are available in the following registries:\n\n* [Docker](https://hub.docker.com/r/xorilog/telegram): `xorilog/telegram`\n* [GitHub Packages](https://github.com/xorilog/docker-telegram/packages/26101): `docker.pkg.github.com/xorilog/docker-telegram/telegram`\n* [GitHub Container Registry](https://github.com/users/xorilog/packages/container/package/telegram): `ghcr.io/xorilog/telegram`\n\n### Docker \u003c1.8\n\nBefore Docker 1.8 you need to replace `--device /dev/snd` by `-v /dev/snd:/dev/snd --privileged`.\n\n### QXcbConnection: Could not connect to display unix:0\n\n\u003eThis is old but keeping it for older users\n\n```shell\nxhost +\nsetenforce 0 (optional, if `xhost +` is not enough: put SELinux in permissive mode)\n```\n\nDo not forget to remove it after start or usage (`xhost -`, setenforce 1).\n\nThe previous command is to be run on a linux machine. But, Mac users I have a special surprise for you. You can also do fun hacks with X11. Details are described [here](https://github.com/docker/docker/issues/8710).\n[This may be more convenient to read](https://gist.github.com/netgusto/931085fc3673b69dd15a1763784307c5)\n\nThanks to [Telegram](https://telegram.org/) for their great app !\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxorilog%2Fdocker-telegram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxorilog%2Fdocker-telegram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxorilog%2Fdocker-telegram/lists"}