{"id":20671603,"url":"https://github.com/alex289/docker-discord-bot","last_synced_at":"2025-04-19T18:40:36.347Z","repository":{"id":229311608,"uuid":"775157823","full_name":"alex289/docker-discord-bot","owner":"alex289","description":"An easy-to-use Discord bot to manage your Docker containers.","archived":false,"fork":false,"pushed_at":"2024-11-16T11:22:11.000Z","size":117,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-16T12:23:33.651Z","etag":null,"topics":["bot","discord","docker"],"latest_commit_sha":null,"homepage":"","language":"C#","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/alex289.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-20T21:35:58.000Z","updated_at":"2024-11-16T11:22:14.000Z","dependencies_parsed_at":"2024-05-01T07:26:32.075Z","dependency_job_id":"16338d21-94c4-45fb-b47c-fb0b274c2d3f","html_url":"https://github.com/alex289/docker-discord-bot","commit_stats":null,"previous_names":["alex289/docker-discord-bot"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex289%2Fdocker-discord-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex289%2Fdocker-discord-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex289%2Fdocker-discord-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex289%2Fdocker-discord-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alex289","download_url":"https://codeload.github.com/alex289/docker-discord-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224969509,"owners_count":17400274,"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":["bot","discord","docker"],"created_at":"2024-11-16T20:28:18.330Z","updated_at":"2025-04-19T18:40:36.341Z","avatar_url":"https://github.com/alex289.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker Discord Bot\n\n![GitHub License](https://img.shields.io/github/license/alex289/docker-discord-bot)\n![Docker Pulls](https://img.shields.io/docker/pulls/alexdev28/docker-discord-bot)\n[![CodeFactor](https://www.codefactor.io/repository/github/alex289/docker-discord-bot/badge)](https://www.codefactor.io/repository/github/alex289/docker-discord-bot)\n![Docker Image Size](https://img.shields.io/docker/image-size/alexdev28/docker-discord-bot)\n\nAn easy-to-use Discord bot to manage your Docker containers.\n\n## Table of Contents\n\n- [Commands](#commands)\n- [Installation](#installation)\n  - [Discord Bot Setup](#discord-bot-setup)\n  - [Docker Setup](#docker-setup)\n  - [Configuration](#configuration)\n- [License](#license)\n\n## Commands\n\n| Command | Description |\n| --- | --- |\n| `!help` | Show all available commands |\n| `!ping` | Check if the bot is online |\n| `!dockerps` | List all running Docker containers |\n| `!dockerstop \u003ccontainer\u003e` | Stop a Docker container |\n| `!dockerstart \u003ccontainer\u003e` | Start a Docker container |\n| `!dockerrestart \u003ccontainer\u003e` | Restart a Docker container |\n| `!dockerremove \u003ccontainer\u003e` | Remove a Docker container |\n| `!dockershow \u003ccontainer\u003e` | Show information about a Docker container |\n| `!dockercreate \u003cimage\u003e:\u003ctag\u003e/\u003cimage\u003e \u003cname\u003e \u003cports (80:80,81:81)\u003e` | Create a new Docker container |\n| `!dockerinfo` | Show information about the Docker host |\n| `!dockerimages` | List all existing images |\n| `!dockerpull \u003cimage\u003e:\u003ctag\u003e/\u003cimage\u003e` | Pull an image |\n| `!dockerremoveimage \u003cimage\u003e` | Remove an image |\n\n## Installation\n\n### Discord Bot Setup\n\n1.  Create a new Discord bot at the [Discord Developer Portal](https://discord.com/developers/applications)\n2.  Copy the bot token\n3.  Invite the bot to your server using the following link: `https://discord.com/oauth2/authorize?client_id=YOUR_BOT_ID\u0026permissions=8\u0026scope=bot`\n\n### Docker Setup\n\nRun the following command to start the Docker container:\n\n```bash\ndocker run \\\n    -d \\\n    --name docker-discord-bot \\\n    -u root \\\n    -e ApplicationSettings__DiscordToken=YOUR_DISCORD_BOT_TOKEN \\\n    -v /var/run/docker.sock:/var/run/docker.sock \\\n    alexdev28/docker-discord-bot:latest\n```\n\nOr with docker compose:\n\n```yaml\nversion: '3.8'\n\nservices:\n  docker-discord-bot:\n    image: alexdev28/docker-discord-bot:latest\n    container_name: docker-discord-bot\n    restart: unless-stopped\n    user: root\n    environment:\n      - ApplicationSettings__DiscordToken=YOUR_DISCORD_BOT_TOKEN\n    volumes:\n      - /var/run/docker.sock:/var/run/docker.sock\n```\n\n### Configuration\n\nThe bot can be configured using environment variables:\n\n| Environment Variable | Description | Default Value | Required |\n| --- | --- | --- | --- |\n| `ApplicationSettings__DiscordToken` | Discord bot token | `null` | ✅ |\n| `ApplicationSettings__AdminUser` | Discord admin username | `null` | ❌ |\n| `ApplicationSettings__CommandPrefix` | Command prefix | `!` | ❌ |\n| `ApplicationSettings__DockerRegistryUrl` | Private registry url | `null` | ❌ |\n| `ApplicationSettings__DockerRegistryUsername` | Private registry username | `null` | ❌ |\n| `ApplicationSettings__DockerRegistryPassword` | Private registry password | `null` | ❌ |\n\n## License\n\n© [Alexander Konietzko](https://alexanderkonietzko.com) 2025  \nReleased under the [MIT license](https://github.com/alex289/docker-discord-bot/blob/main/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falex289%2Fdocker-discord-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falex289%2Fdocker-discord-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falex289%2Fdocker-discord-bot/lists"}