{"id":17686014,"url":"https://github.com/geekmasher/wicket-discord-docker-bot","last_synced_at":"2026-02-09T13:04:33.942Z","repository":{"id":42649555,"uuid":"389109392","full_name":"GeekMasher/wicket-discord-docker-bot","owner":"GeekMasher","description":"Wicket - The Discord Docker Bot to link your Docker deployments to Discord","archived":false,"fork":false,"pushed_at":"2025-02-11T19:30:58.000Z","size":561,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-10T12:46:09.790Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/GeekMasher.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2021-07-24T13:47:01.000Z","updated_at":"2025-01-29T02:53:35.000Z","dependencies_parsed_at":"2023-10-14T21:25:04.208Z","dependency_job_id":"a029fe26-75d6-4245-8778-3ea7b4812c09","html_url":"https://github.com/GeekMasher/wicket-discord-docker-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GeekMasher/wicket-discord-docker-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeekMasher%2Fwicket-discord-docker-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeekMasher%2Fwicket-discord-docker-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeekMasher%2Fwicket-discord-docker-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeekMasher%2Fwicket-discord-docker-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GeekMasher","download_url":"https://codeload.github.com/GeekMasher/wicket-discord-docker-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeekMasher%2Fwicket-discord-docker-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29266130,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T12:53:16.161Z","status":"ssl_error","status_checked_at":"2026-02-09T12:52:30.244Z","response_time":56,"last_error":"SSL_read: 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":[],"created_at":"2024-10-24T10:29:43.032Z","updated_at":"2026-02-09T13:04:33.925Z","avatar_url":"https://github.com/GeekMasher.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wicket-discord-docker-bot\n\nWicket - The Discord Docker Bot to link your Docker deployments to Discord\n\nThis bot was created to make it easier for a Discord user to list, start, and stop Docker containers primarily for gaming servers.\n\nThe name [Wicket (Wicket Wystri Warrick) comes from the Star Wars Ewok character](https://starwars.fandom.com/wiki/Wicket_Wystri_Warrick).\n\n\n### Quick start\n\nCreate a `.env` file and add the following keys and their values:\n\n```env\n# Discord Bot/App token\nDISCORD_TOKEN=ABCDEFG\n\nDISCORD_ADMINS=MyUser#1234,MyOtherUser#4321\n\n# [optional] Docker socket\nDOCKER_HOST=/var/run/docker.sock\n```\n\nStart up the Docker container using the `.env` file.\n\n```bash\ndocker run -d --env-file=.env --name wicket \\\n  ghcr.io/geekmasher/wicket-discord-docker-bot:main\n```\n\n\n## Setup\n\nThere are three core parts to setting up the bot; configuration file, Discord token, and Docker socket.\n\n### Configuration file\n\nThis isn't needed and is optional but gives administrators better control over how the bot is used.\n\n```yml\ndomain: domain.example.com\n\n# Discord servers\nservers:\n  example:\n    name: Example Server Name\n    admins:\n      - MyUser#1234\n\ndocker-labels:\n  - com.example.services.type=gaming\n\n```\n\n### Discord Token\n\nTo communicate to and from Discord you'll need an Application Discord Token to pass into the Bot.\nThis can be set as the environment variable `DISCORD_TOKEN`:\n\n```\nDISCORD_TOKEN=ABCDEFG\n```\n\nThis can also be passed in manually using the `--token` argument.\n\n```bash\npipenv run python -m wicket --token $MY_DISCORD_TOKEN\n```\n\n### Docker Socket\n\nTo connect to the Doker daemon you'll need access to the Docker socket on the local or remote machine.\n\nThis is done by connecting to the local system Docker enviroment using a number of methods including the `DOCKER_HOST` environment variable.\n\n```env\n# Local Unix Socket\nDOCKER_HOST=/var/run/docker.sock\n\n# Remote Socket\nDOCKER_HOST=ssh://user@1.1.1.1\n\n```\n\n## Security\n\n### Docket Socket\n\nThe Docker socket is extremely important to protect as if an attacker has access to the socket they would have unrestricted access to the Docker host.\n\nRead the following documentation on the subject:\n\n- [Docker security](https://docs.docker.com/engine/security/)\n- [Protect the Docker daemon socket](https://docs.docker.com/engine/security/protect-access/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeekmasher%2Fwicket-discord-docker-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeekmasher%2Fwicket-discord-docker-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeekmasher%2Fwicket-discord-docker-bot/lists"}