{"id":40595235,"url":"https://github.com/bandsintown/docker-alpine","last_synced_at":"2026-01-21T03:36:48.564Z","repository":{"id":45035450,"uuid":"70658400","full_name":"bandsintown/docker-alpine","owner":"bandsintown","description":"Base Docker images based on Alpine Linux","archived":false,"fork":false,"pushed_at":"2024-04-23T01:52:47.000Z","size":2880,"stargazers_count":0,"open_issues_count":2,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-04-24T01:47:14.030Z","etag":null,"topics":["consul-template","dns-resolver","docker","docker-alpine"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bandsintown.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2016-10-12T03:20:37.000Z","updated_at":"2022-01-06T21:41:13.000Z","dependencies_parsed_at":"2024-03-21T19:30:31.254Z","dependency_job_id":"4197a95a-3d3f-41af-ad20-bc199a047760","html_url":"https://github.com/bandsintown/docker-alpine","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/bandsintown/docker-alpine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bandsintown%2Fdocker-alpine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bandsintown%2Fdocker-alpine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bandsintown%2Fdocker-alpine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bandsintown%2Fdocker-alpine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bandsintown","download_url":"https://codeload.github.com/bandsintown/docker-alpine/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bandsintown%2Fdocker-alpine/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28624570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T02:47:06.670Z","status":"ssl_error","status_checked_at":"2026-01-21T02:45:44.886Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["consul-template","dns-resolver","docker","docker-alpine"],"created_at":"2026-01-21T03:36:48.496Z","updated_at":"2026-01-21T03:36:48.557Z","avatar_url":"https://github.com/bandsintown.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![dockeri.co](http://dockeri.co/image/bandsintown/alpine)](https://hub.docker.com/r/bandsintown/alpine/)\n\n[![Build status](https://badge.buildkite.com/f78e045c0b561ba33f80f3c996ccfe89b49ade24b832f92bfd.svg)](https://buildkite.com/bandsintown/docker-alpine)\n[![GitHub issues](https://img.shields.io/github/issues/bandsintown/docker-alpine.svg \"GitHub issues\")](https://github.com/bandsintown/docker-alpine)\n[![GitHub stars](https://img.shields.io/github/stars/bandsintown/docker-alpine.svg \"GitHub stars\")](https://github.com/bandsintown/docker-alpine)\n[![Docker layers](https://images.microbadger.com/badges/image/bandsintown/alpine.svg)](http://microbadger.com/images/bandsintown/alpine)\n\t\n# What is Alpine Linux?\n\n![logo](https://github.com/bandsintown/docker-alpine/blob/master/logo.png)\n\n[Alpine Linux](http://alpinelinux.org/) is a very small Linux distribution built around [musl libc](http://www.musl-libc.org/) and [BusyBox](http://www.busybox.net/).\n\nThis makes Alpine Linux a great image base for utilities and even production applications. [Read more about Alpine Linux here](https://www.alpinelinux.org/about/) and you can see how their mantra fits in right at home with Docker images.\n\n\n# About\n\nThis image is derived from the well tested and documented [Alpine Docker image](http://gliderlabs.viewdocs.io/docker-alpine/) image adding: \n - the [s6 supervisor for containers](https://github.com/just-containers/s6-overlay) \n - a lightweight [DNS resolver](https://github.com/janeczku/go-dnsmasq) with minimal runtime and filesystem overhead \n - [Consul Template](https://github.com/hashicorp/consul-template) for service discovery and configuration management\n - some useful packages: `bash`, `tree`, `curl`, `wget`, \n - since 3.5 this packages have been added:`jq`, `bind-tools`, `consul`\n\n## Motivation\n\nAlpine Linux does not support the `search` keyword in resolv.conf. This breaks many tools that rely on DNS service discovery (e.g. Kubernetes, Tutum.co, Consul).\n\nAdditionally Alpine Linux deviates from the established concept of primary and secondary nameservers. This leads to problems in cases where the container is configured with multiple nameserver with inconsistent records (e.g. one Consul server and one recursing server).\n    \nTo overcome these issues the image includes a lightweight (1.2 MB) container-only [DNS resolver](https://github.com/janeczku/go-dnsmasq) that replicates the behavior of GNU libc's stub-resolver.\n\n## How it works\n\nOn container start the DNS resolver parses the `nameserver` and `search` entries from `resolv.conf` and configures itself as nameserver for the container. DNS queries from local processes are handled following these conventions:\n* The nameserver listed first in resolv.conf is always queried first. Additional nameservers are treated as fallbacks.\n* Hostnames are qualified by appending the domains configured with the `search` keyword in resolv.conf\n* Single-label hostnames (e.g.: \"redis-master\") are always qualified with search domains\n* Multi-label hostnames are first tried as absolute names and only then qualified with search domains\n\n\n# Usage\n\nThe official Alpine Docker image is well documented, so check out [their documentation](http://gliderlabs.viewdocs.io/docker-alpine) to learn more about building micro Docker images with Alpine Linux.\n\n## Basic usage    \n\nBuilding your own image based on this image is as easy as:\n\n\n```Dockerfile\nFROM bandsintown/alpine\nRUN apk-install \u003cpackage_name\u003e\n\nCMD [\"/bin/bash\"]\n```\n\nor :\n\n```\ndocker run -ti bandsintown/alpine\n```\n\n## Supervised services\n\nBy default the [s6 supervisor](https://github.com/just-containers/s6-overlay) is enabled because the `ENTRYPOINT` is  defined to `/init`.\n\n### DNS resolver\n\nIn the case you need to disable the [DNS resolver](https://github.com/janeczku/go-dnsmasq) you can just pass the environment variable `DISABLE_DNSMASQ`:\n\n```\ndocker run -ti --entrypoint=/init -e DISABLE_DNSMASQ=true bandsintown/alpine bash \n```\n\n### Consul Template\n\nIn the case you need to disable [Consul Template](https://github.com/hashicorp/consul-template) you can just pass the environment variable `DISABLE_CONSUL_TEMPLATE`:\n\n```\ndocker run -ti --entrypoint=/init -e DISABLE_CONSUL_TEMPLATE=true bandsintown/alpine bash \n```\n\nThe `CONSUL_HTTP_ADDR` might be passed as an environment variable to define the address of Consul:\n\n```\ndocker run -ti --entrypoint=/init -e CONSUL_HTTP_ADDR=demo.consul.io bandsintown/alpine bash \n```\n\n\nAlternatively if you run your containers on AWS and you need to get the host IP, you can use the variable `RUN_ON_AWS`:\n\n```\ndocker run -ti --entrypoint=/init -e RUN_ON_AWS=true bandsintown/alpine bash \n```\n\nThe configuration of Consul template must be located in `/etc/consul-template/conf`.\n\n\n# Build\n\nThis project is configured as an [automated build in Dockerhub](https://hub.docker.com/r/bandsintown/alpine/).\n\nEach branch give the related image tag.  \n\n# License\n\nAll the code contained in this repository, unless explicitly stated, is\nlicensed under ISC license.\n\nA copy of the license can be found inside the [LICENSE](LICENSE) file.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbandsintown%2Fdocker-alpine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbandsintown%2Fdocker-alpine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbandsintown%2Fdocker-alpine/lists"}