{"id":22487400,"url":"https://github.com/serversideup/github-action-docker-build","last_synced_at":"2025-12-25T09:33:42.931Z","repository":{"id":62065967,"uuid":"557431745","full_name":"serversideup/github-action-docker-build","owner":"serversideup","description":"Build and publish docker images automatically with GitHub Actions ⚡️","archived":false,"fork":false,"pushed_at":"2024-01-03T19:12:48.000Z","size":156,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-17T00:10:57.509Z","etag":null,"topics":["ci","cicd","docker","docker-build","docker-builds","docker-buildx","docker-buildx-qemu","github-actions"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/serversideup.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":"serversideup"}},"created_at":"2022-10-25T17:18:25.000Z","updated_at":"2025-02-20T03:14:12.000Z","dependencies_parsed_at":"2024-01-03T20:39:33.937Z","dependency_job_id":null,"html_url":"https://github.com/serversideup/github-action-docker-build","commit_stats":{"total_commits":16,"total_committers":2,"mean_commits":8.0,"dds":0.0625,"last_synced_commit":"dc6480228e7968542620c93e7fbe27ae35cd1de6"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/serversideup/github-action-docker-build","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serversideup%2Fgithub-action-docker-build","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serversideup%2Fgithub-action-docker-build/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serversideup%2Fgithub-action-docker-build/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serversideup%2Fgithub-action-docker-build/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/serversideup","download_url":"https://codeload.github.com/serversideup/github-action-docker-build/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serversideup%2Fgithub-action-docker-build/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268448362,"owners_count":24252019,"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","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"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":["ci","cicd","docker","docker-build","docker-builds","docker-buildx","docker-buildx-qemu","github-actions"],"created_at":"2024-12-06T17:16:32.917Z","updated_at":"2025-12-25T09:33:42.921Z","avatar_url":"https://github.com/serversideup.png","language":null,"funding_links":["https://github.com/sponsors/serversideup"],"categories":["Others"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\t\t\u003cimg src=\"https://raw.githubusercontent.com/serversideup/github-action-docker-build/main/.github/readme-header.png\" width=\"1280\" alt=\"Header Image\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://github.com/serversideup/github-action-docker-build/blob/main/LICENSE\" target=\"_blank\"\u003e\u003cimg src=\"https://badgen.net/github/license/serversideup/github-action-docker-build\" alt=\"License\"\u003e\u003c/a\u003e\n\t\u003ca href=\"https://github.com/sponsors/serversideup\"\u003e\u003cimg src=\"https://badgen.net/badge/icon/Support%20Us?label=GitHub%20Sponsors\u0026color=orange\" alt=\"Support us\"\u003e\u003c/a\u003e\n  \u003cbr /\u003e\n  \u003ca href=\"https://community.serversideup.net\"\u003e\u003cimg alt=\"Discourse users\" src=\"https://img.shields.io/discourse/users?color=blue\u0026server=https%3A%2F%2Fcommunity.serversideup.net\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://serversideup.net/discord\"\u003e\u003cimg alt=\"Discord\" src=\"https://img.shields.io/discord/910287105714954251?color=blueviolet\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nHi! We're [Dan](https://twitter.com/danpastori) and [Jay](https://twitter.com/jaydrogers). We're a two person team with a passion for open source products. We created [Server Side Up](https://serversideup.net) to help share what we learn.\n\n### Find us at:\n\n* 📖 [Blog](https://serversideup.net) - get the latest guides and free courses on all things web/mobile development.\n* 🙋 [Community](https://community.serversideup.net) - get friendly help from our community members.\n* 🤵‍♂️ [Get Professional Help](https://serversideup.net/get-help) - get guaranteed responses within next business day.\n* 💻 [GitHub](https://github.com/serversideup) - check out our other open source projects\n* 📫 [Newsletter](https://serversideup.net/subscribe) - skip the algorithms and get quality content right to your inbox\n* 🐥 [Twitter](https://twitter.com/serversideup) - you can also follow [Dan](https://twitter.com/danpastori) and [Jay](https://twitter.com/jaydrogers)\n* ❤️ [Sponsor Us](https://github.com/sponsors/serversideup) - please consider sponsoring us so we can create more helpful resources\n\n### Our Sponsors\nAll of our software is free an open to the world. None of this can be brought to you without the financial backing of our sponsors.\n\n#### Individual Supporters\n\u003c!-- supporters --\u003e\u003ca href=\"https://github.com/deligoez\"\u003e\u003cimg src=\"https://github.com/deligoez.png\" width=\"40px\" alt=\"deligoez\" /\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u003ca href=\"https://github.com/alexjustesen\"\u003e\u003cimg src=\"https://github.com/alexjustesen.png\" width=\"40px\" alt=\"alexjustesen\" /\u003e\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u003c!-- supporters --\u003e\n\n# About this project\nThis is a GitHub Action intended to simplify the process for building automated Docker images with GitHub Actions.\n\n### Features:\n- ✅ **Stupid simple to use** - just pass in the tags, registry, and credentials and you're good to go\n- 🚀 **Customize your docker image names/tags** - easily pass in what you want it to be\n- 🤓 **Multi-arch support** - build for multiple architectures\n- 📦 **Multi-registry support** - build and push to up to 3 registries simultaneously (Docker Hub, GitHub Container Registry, and private registries)\n- 🔀 **Context aware** - great if you have a Dockerfile in a different part of your repo\n\n# Usage\n\n## Single Registry Example\nHere is a basic example workflow for publishing to a single registry:\n\n```yml\nname: Docker Publish (Production Images)\non:\n  push:\n\njobs:\n  docker-publish:\n    runs-on: ubuntu-24.04\n    steps:\n      - name: Checkout\n        uses: actions/checkout@v4\n      \n      - name: Build and push Docker image\n        uses: serversideup/github-action-docker-build@v6\n        with:\n          tags: serversideup/financial-freedom:latest\n          registry-username: ${{ secrets.DOCKER_HUB_USERNAME }}\n          registry-password: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}\n          platforms: \"linux/amd64,linux/arm/v7,linux/arm64/v8\"\n```\n\n## Multiple Registry Example\nYou can now push to up to **3 different registries** in a single build! Perfect for publishing to Docker Hub, GitHub Container Registry, and your own private registry simultaneously:\n\n```yml\nname: Docker Publish (Multiple Registries)\non:\n  push:\n    branches:\n      - main\n\njobs:\n  docker-publish:\n    runs-on: ubuntu-24.04\n    steps:\n      - name: Checkout\n        uses: actions/checkout@v4\n      \n      - name: Build and push to multiple registries\n        uses: serversideup/github-action-docker-build@v6\n        with:\n          # Tag with multiple registry prefixes\n          tags: |\n            docker.io/myorg/myapp:latest\n            ghcr.io/myorg/myapp:latest\n            registry.example.com/myapp:latest\n          \n          # Registry 1: Docker Hub\n          registry: \"docker.io\"\n          registry-username: ${{ secrets.DOCKER_HUB_USERNAME }}\n          registry-password: ${{ secrets.DOCKER_HUB_TOKEN }}\n          \n          # Registry 2: GitHub Container Registry\n          registry-2: \"ghcr.io\"\n          registry-2-username: ${{ github.actor }}\n          registry-2-password: ${{ secrets.GITHUB_TOKEN }}\n          \n          # Registry 3: Custom Private Registry\n          registry-3: \"registry.example.com\"\n          registry-3-username: ${{ secrets.CUSTOM_REGISTRY_USER }}\n          registry-3-password: ${{ secrets.CUSTOM_REGISTRY_TOKEN }}\n          \n          platforms: \"linux/amd64,linux/arm64\"\n```\n\n**💡 Pro tip:** You only need to specify the registries you want to use. Registry 2 and 3 are optional and will be skipped if credentials aren't provided.\n### Configuration options\n**🔀 Input Name**|**📚 Description**|**🛑 Required**|**👉 Default**\n:-----:|:-----:|:-----:|:-----:\ntags|Enter the tag(s) you would like to name your image with. (example: `myorg/myapp:production`) Use multi-line format for multiple tags.|⚠️ Yes| \nregistry|Choose which container image repository to upload to. \u003ca href=\"https://github.com/docker/login-action#usage\"\u003eSee all options.\u003c/a\u003e| |`docker.io`\nregistry-username|Enter the username to authenticate with your first registry.|⚠️ Yes| \nregistry-password|Enter the password or token to authenticate with your registry. (an access token is highly recommended)|⚠️ Yes|  \nregistry-token (deprecated)| Use `registry-password` instead||\ncontext|The build context directory (the directory containing your Dockerfile and build files).| |`.`\ndockerfile|Filename of the Dockerfile within the context that you set.| |`./Dockerfile`\nplatforms|Comma separated list of \u003ca href=\"https://github.com/docker-library/official-images#architectures-other-than-amd64\"\u003eplatforms\u003c/a\u003e.| |`linux/amd64`\ntarget|The target build stage to build.| |\n\n#### If you have more than one registry\n**🔀 Input Name**|**📚 Description**|**🛑 Required**|**👉 Default**\n:-----:|:-----:|:-----:|:-----:\nregistry-2|Choose which container image repository to upload to. \u003ca href=\"https://github.com/docker/login-action#usage\"\u003eSee all options.\u003c/a\u003e| |\nregistry-2-username|Enter the username to authenticate with your second registry.|⚠️ Yes (if you use the 2nd registry)| \nregistry-2-password|Enter the token or password to authenticate with your second registry. (an access token is highly recommended)|⚠️ Yes (if you use the 2nd registry)|  \nregistry-3|Choose which container image repository to upload to. \u003ca href=\"https://github.com/docker/login-action#usage\"\u003eSee all options.\u003c/a\u003e| |\nregistry-3-username|Enter the username to authenticate with your third registry.|⚠️ Yes (if you use the 3rd registry)| \nregistry-3-password|Enter the token or password to authenticate with your third registry. (an access token is highly recommended)|⚠️ Yes (if you use the 3rd registry)|  \n\n\u003e [!NOTE]  \n\u003e At least one registry's credentials must be provided (either registry 1, 2, or 3).\n\n### Important security notice\nAlways use encrypted secrets when passing sensitive information. [Learn more here →](https://docs.github.com/en/actions/security-guides/encrypted-secrets)\n\n### Security Disclosures\nIf you find a security vulnerability, please let us know as soon as possible.\n\n[View Our Responsible Disclosure Policy →](https://www.notion.so/Responsible-Disclosure-Policy-421a6a3be1714d388ebbadba7eebbdc8)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserversideup%2Fgithub-action-docker-build","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fserversideup%2Fgithub-action-docker-build","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserversideup%2Fgithub-action-docker-build/lists"}