Official Repository

Last pushed: a day ago
Short Description
A minimal Docker image based on Alpine Linux with a complete package index and only 5 MB in size!
Full Description

Supported tags and respective Dockerfile links

Quick reference

What is Alpine Linux?

Alpine Linux is a Linux distribution built around musl libc and BusyBox. The image is only 5 MB in size and has access to a package repository that is much more complete than other BusyBox based images. This makes Alpine Linux a great image base for utilities and even production applications. Read more about Alpine Linux here and you can see how their mantra fits in right at home with Docker images.

How to use this image

Usage

Use like you would any other base image:

FROM alpine:3.5
RUN apk add --no-cache mysql-client
ENTRYPOINT ["mysql"]

This example has a virtual image size of only 36.5MB. Compare that to our good friend Ubuntu:

FROM ubuntu:16.04
RUN apt-get update \
    && apt-get install -y --no-install-recommends mysql-client \
    && rm -rf /var/lib/apt/lists/*
ENTRYPOINT ["mysql"]

This yields us a virtual image size of about 184MB image.

Documentation

This image is well documented. Check out the documentation at Viewdocs.

Docker Pull Command

Comments (42)
patrickrainier
22 days ago

I am installing Xvfb and I can't run xvfb-run command. It says that it is not found. I tried the same process in ubuntu and I can immediately run xvfb-run. Is there something that I may have missed?

smtripat
a month ago

Thanks a lot guys for such a quick response.

smtripat
a month ago

I'm trying to use php7-redis same as ivansoshnikov. But can't use it as it is only available in v 3.6. Please provide new Image v 3.6 so that we can use php7-redis along with it .

inmyth
3 months ago

Is there a way to install rpm packages with apk ?

bekce
3 months ago

To install stuff, use apk add --update package command. Don't forget --update or it will fail on the first run.

rawat3
3 months ago

Hi,

With the latest version (3.5), I am experiencing below error.

fetch http://dl-4.alpinelinux.org/alpine/v3.5/community/x86_64/APKINDEX.tar.gz
ERROR: http://dl-4.alpinelinux.org/alpine/v3.5/community: DNS lookup error
fetch http://dl-4.alpinelinux.org/alpine/v3.5/community/x86_64/APKINDEX.tar.gz
WARNING: Ignoring http://dl-4.alpinelinux.org/alpine/v3.5/community/x86_64/APKINDEX.tar.gz: DNS lookup error
fetch http://dl-4.alpinelinux.org/alpine/v3.5/main/x86_64/APKINDEX.tar.gz
ERROR: http://dl-4.alpinelinux.org/alpine/v3.5/main: DNS lookup error
fetch http://dl-4.alpinelinux.org/alpine/v3.5/main/x86_64/APKINDEX.tar.gz
WARNING: Ignoring http://dl-4.alpinelinux.org/alpine/v3.3/main/x86_64/APKINDEX.tar.gz: DNS lookup error
ERROR: unsatisfiable constraints:
  bash (missing):
    required by: world[bash]
  ca-certificates (missing):
    required by: world[ca-certificates]
  curl (missing):
    required by: world[curl]

Can anyone please help me on resolving it and moving forward

Thanks

abyu
4 months ago

does anyone know what the root password is ?

ivansoshnikov
4 months ago

I search php7-redis and found this:
https://pkgs.alpinelinux.org/package/edge/testing/x86_64/php7-redis
In Dockerfile I do apk update && apk upgrade.
But alpine:latest and alpine:edge can't find this package.
May be I doing something wrong?
Thank you.
And thank you for avesome distrib, for your job.

noble247
5 months ago

Hi! Is there any plan to officially support a "glibc" version any time in the future? The official busybox images have a "glibc" version, but they don't have a default package manager like y'all, and I doubt the same community support. Official support for a solution that has "glibc" and a package manager would really help me make a case for my company to adopt this as a viable base image for our production needs. Thanks in advance!!!

khawajagan
5 months ago

I was trying the docker tutorial (self paced) and was unable to complete the tutorial's first docker app creation due to the builder failed at RUN APK ADD PY-PIP STEP giving unsatisfiable constraint error.
I resolved this issue by building the docker with 3.4 image instead of latest (3.5) which just goes fine.