docker-alpine - GitLite

KO | EN

gitlite — search

#javascript #python #react #machine-learning #docker #java #nodejs #awesome #cli #kubernetes #security #ios #mcp #open-source

docker-alpine

(★ 5,698)

Alpine Linux Docker image. Win at minimalism!

File Explorer

Download Latest Version (.zip)

- config.yml
- - apk-install
  - mkimage-alpine.bash
- Dockerfile
- README.md
- about.md
- build.md
- caveats.md
- index.md
- usage.md
- test_alpine-3.1.bats
- test_alpine-3.2.bats
- test_alpine-3.3.bats
- test_alpine-3.4.bats
- test_alpine-3.5.bats
- test_alpine-3.6.bats
- test_alpine-3.7.bats
- test_alpine-3.8.bats
- test_alpine-3.9.bats
- test_alpine-edge.bats
- test_gliderlabs_alpine-3.1.bats
- test_gliderlabs_alpine-3.2.bats
- test_gliderlabs_alpine-3.3.bats
- test_gliderlabs_alpine-3.4.bats
- test_gliderlabs_alpine-3.5.bats
- test_gliderlabs_alpine-3.6.bats
- test_gliderlabs_alpine-3.7.bats
- test_gliderlabs_alpine-3.8.bats
- test_gliderlabs_alpine-3.9.bats
- test_gliderlabs_alpine-edge.bats
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
- - Dockerfile
  - options
.gitignore
build
LICENSE
logo.png
logo_fastly.png
README-short.txt
README.md

🚀 Installation Guide

1. Get the code

git clone https://github.com/gliderlabs/docker-alpine

Downloads the entire project code from GitHub to your computer.

cd docker-alpine

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

$ docker run progrium/busybox opkg-install nodejs

Runs the built image as an actual container.

$ docker run gliderlabs/alpine apk add --no-cache nodejs

Runs the built image as an actual container.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# docker-alpine

[![CircleCI](https://img.shields.io/circleci/project/github/gliderlabs/docker-alpine/release.svg)](https://circleci.com/gh/gliderlabs/docker-alpine)
[![Docker Stars](https://img.shields.io/docker/stars/gliderlabs/alpine.svg)][hub]
[![Docker Pulls](https://img.shields.io/docker/pulls/gliderlabs/alpine.svg)][hub]
[![Slack](http://glider-slackin.herokuapp.com/badge.svg)][slack]

A super small Docker image based on [Alpine Linux][alpine]. The image is only 5 MB and has access to a package repository that is much more complete than other BusyBox based images.

## Why?

Docker images today are big. Usually much larger than they need to be. There are a lot of ways to make them smaller, but the Docker populace still jumps to the `ubuntu` base image for most projects. The size savings over `ubuntu` and other bases are huge:

```
REPOSITORY          TAG           IMAGE ID          VIRTUAL SIZE
gliderlabs/alpine   latest        9cfff538e583      4.803 MB
debian              latest        19134a8202e7      123.1 MB
ubuntu              latest        104bec311bcd      129 MB
centos              latest        67591570dd29      191.8 MB
```

There are images such as `progrium/busybox` which get us very close to a minimal container and package system. But these particular BusyBox builds piggyback on the OpenWRT package index which is often lacking and not tailored towards generic everyday applications. Alpine Linux has a much more complete and up to date [package index][alpine-packages]:

```console
$ docker run progrium/busybox opkg-install nodejs
Unknown package 'nodejs'.
Collected errors:
* opkg_install_cmd: Cannot install package nodejs.

$ docker run gliderlabs/alpine apk add --no-cache nodejs
fetch http://alpine.gliderlabs.com/alpine/v3.3/main/x86_64/APKINDEX.tar.gz
fetch http://alpine.gliderlabs.com/alpine/v3.3/community/x86_64/APKINDEX.tar.gz
(1/4) Installing libgcc (5.3.0-r0)
(2/4) Installing libstdc++ (5.3.0-r0)
(3/4) Installing libuv (1.7.5-r0)
(4/4) Installing nodejs (4.2.3-r0)
Executing busybox-1.24.1-r7.trigger
OK: 29 MiB in 15 packages
```

This makes Alpine Linux a great image base for utilities and even production applications. [Read more about Alpine Linux here][alpine-about] and you can see how their mantra fits in right at home with Docker images.

## Usage

Stop doing this:

```dockerfile
FROM ubuntu-debootstrap:14.04
RUN apt-get update -q \
  && DEBIAN_FRONTEND=noninteractive apt-get install -qy mysql-client \
  && apt-get clean \
  && rm -rf /var/lib/apt
ENTRYPOINT ["mysql"]
```
This took 19 seconds to build and yields a 164 MB image. Eww. Start doing this:

```dockerfile
FROM gliderlabs/alpine:3.4
RUN apk add --no-cache mysql-client
ENTRYPOINT ["mysql"]
```

Only 3 seconds to build and results in a 36 MB image! Hooray!

## Documentation

This image is well documented. [Check out the documentation at Viewdocs][docs] and the `docs` directory in this repository.

## Contacts

We make reasonable efforts to support our work and are always happy to chat. Join us in [our Slack community][slack] or [submit a GitHub issue][issues] if you have a security or other general question about this Docker image. Please email [security](http://lists.alpinelinux.org/alpine-security/summary.html) or [user](http://lists.alpinelinux.org/alpine-user/summary.html) mailing lists if you have concerns specific to Alpine Linux.

## Inspiration

The motivation for this project and modifications to `mkimage.sh` are highly inspired by Eivind Uggedal (uggedal) and Luis Lavena (luislavena). They have made great strides in getting Alpine Linux running as a Docker container. Check out their [mini-container/base][mini-base] image as well.

## Sponsors

[![Fastly](https://github.com/gliderlabs/docker-alpine/raw/master/logo_fastly.png)][fastly]

[Fastly][fastly] provides the CDN for our Alpine Linux package repository. This allows super speedy package downloads from all over the globe!

## License

The code in this repository, unless otherwise noted, is BSD licensed. See the `LICENSE` file in this repository.

[mini-base]: https://github.com/mini-containers/base
[alpine-packages]: http://pkgs.alpinelinux.org/
[alpine-about]: https://www.alpinelinux.org/about/
[docs]: http://gliderlabs.viewdocs.io/docker-alpine
[slack]: http://glider-slackin.herokuapp.com/
[issues]: https://github.com/gliderlabs/docker-alpine/issues
[alpine]: http://alpinelinux.org/
[fastly]: https://www.fastly.com/
[hub]: https://hub.docker.com/r/gliderlabs/alpine/
<img src="https://ga-beacon.appspot.com/UA-58928488-2/docker-alpine/readme?pixel" />