Public Repository

Last pushed: a year ago
Short Description
97 MB Arch Linux, ArchAssault, BlackArch, BBQLinux Image
Full Description


On Docker hub archlinux-tiny
on Github docker-archlinux-tiny

97 MB Arch Linux base container. The goal of this was to build an extremely small Arch Linux base without giving up any functionality.
I used Les Aker's dock0/arch as a foundation.
I also added some amazing repos like ArchAssault,
BlackArch and BBQLinux.

The goal was to maintain complete functionality so I did not swap out coreutils for busybox.
But you could swap out a few things for the busybox version of them and reduce the size down another 20 MB or so.


  • Arch Linux 64 bit core, extra, community repos
  • Arch Linux 32 bit multilib repo
  • BBQLinux repo for Android Developers.
  • ArchAssault repo for penetration testers and security professionals.
  • BlackArch repo for penetration testers and security professionals.
  • Arch Linux CN repo
  • Hercura vim-tiny and other goodies.
  • user:docker password:docker
  • [Reflector] ( mirror optimized for western USA.
  • cower and package-query for interacting with the AUR.
  • compact (removal of a lot of unneeded stuff that pacman will auto re-install if needed)

As an example this is a search for chrome with the above repos installed:


  • acl 2.2.52-2
  • archassault-keyring 20140202-3
  • archassault-mirrorlist 20150214-1
  • archlinux-keyring 20150212-1
  • archlinuxcn-keyring 20141118-1
  • attr 2.4.47-1
  • bash 4.3.033-1
  • bbqlinux-keyring 20131129-1
  • blackarch-keyring 20140118-3
  • bzip2 1.0.6-5
  • ca-certificates 20140923-9
  • ca-certificates-cacert 20140824-2
  • ca-certificates-mozilla 3.18-3
  • ca-certificates-utils 20140923-9
  • coreutils 8.23-1
  • cower 12-2
  • cracklib 2.9.1-1
  • curl 7.41.0-1
  • e2fsprogs 1.42.12-2
  • expat 2.1.0-4
  • filesystem 2015.02-1
  • findutils 4.4.2-6
  • gawk 4.1.1-1
  • gcc-libs 4.9.2-4
  • glibc 2.21-2
  • gmp 6.0.0-2
  • gnupg 2.1.2-3
  • gnutls 3.3.14-2
  • gpgme 1.5.3-1
  • iana-etc 2.30-4
  • keyutils 1.5.9-1
  • krb5 1.13.1-1
  • libarchive 3.1.2-8
  • libassuan 2.1.3-1
  • libcap 2.24-2
  • libffi 3.2.1-1
  • libgcrypt 1.6.3-2
  • libgpg-error 1.18-1
  • libidn 1.30-1
  • libksba 1.3.2-1
  • libldap 2.4.40-2
  • libsasl 2.1.26-7
  • libssh2 1.4.3-2
  • libtasn1 4.4-1
  • libtirpc 0.2.5-1
  • libutil-linux 2.26.1-3
  • licenses 20140629-1
  • linux-api-headers 3.18.5-1
  • localepurge
  • lzo 2.09-1
  • mpfr 3.1.2.p11-1
  • ncurses 5.9-7
  • nettle 2.7.1-1
  • npth 1.1-1
  • openssl 1.0.2.a-1
  • p11-kit 0.23.1-2
  • package-query 1.5-2
  • pacman 4.2.1-1
  • pacman-mirrorlist 20150315-1
  • pam 1.1.8-5
  • pambase 20130928-1
  • pinentry 0.9.0-1
  • pth 2.0.7-5
  • readline 6.3.006-1
  • texinfo-fake 1.2-1
  • tzdata 2015b-1
  • xz 5.2.1-1
  • yajl 2.1.0-1
  • zlib 1.2.8-3

How did you get it so small.

The biggest win was the removal of Perl at 40MB. Perl is needed for two things on the base Arch Linux install
OpenSSL (it shouldn't be honestly since it isn't really used other than for one small thing on Windows)
Some other distros have already fixed this [issue] ( like NixOS
Also, see this thread and this.
And for texinfo (8 MB) which we patched out with a fake stub.

As well as aggressively cleaning of info, doc and man pages as well as stripping out the non English international stuff.


This is slimmed down as much as possible while still having full pacman functionality to install any package needed.
This is ment to be more of the lowest possible base to build upon. Try out one of my other Arch Linux versions if you want something more.

Where it might break is all but the English locales have been removed, as well as any terminfo configs that are not xterm based.
Do not expect any info, documents or manual pages to exist locally either as those have been purged as well.

I am currently experimenting with the removal of zoneinfo and i18n and no problems so far.

Anything you install with pacman should just install fine but if you want to install something from the AUR you are going to need
to install dev tools first like make, gcc, autoconf etc.


To save on space the pacman databases are purged. You need run pacman -Sy at least once before using pacman.

RUN pacman -Sy

Most of the time pacman will install packages and dependencies just fine. Sometimes though it will say
"error: command failed to execute correctly " with a command not found message. That means you need to install a dependency.

For example the git package uses groupadd and useradd which are both in the shadow package but you may not know that so to find it you can use the pkgfile tool.
This will show you which package to install. In this case you would install the shadow package before installing git.

$ pacman -S pkgfile && pkgfile --update
$ pkgfile useradd

This image has a user docker with the password docker. You will most likely want to change the password. Just add this line to your Dockerfile.

RUN echo -e "docker\nyournewpassword" | passwd docker

The mirrors are optimized for US West If you want it for your area just add this to the top of your Dockerfile.

RUN pacman -S reflector --noconfirm && \
    reflector --verbose -l 5 --protocol https --sort rate --save /etc/pacman.d/mirrorlist && \
    pacman -Rs reflector --noconfirm

Included is cower and package-query for interacting with the AUR. You might want another one like
yaourt. To install that just:

RUN pacman -S --noconfirm yaourt

The different repositories have a lot of really nice packages. To get a list just run package-query like this.

package-query -Sl archassault

Random Thoughts (Stuff that you could do that wasn't done)

  • Tried converting coreutils to busybox. It just wasn't worth breaking GNU compatibility that pacman needs.
    Try shingonoide's image first before going this route to see if this works for you.
  • The /etc/include directory contains 14 MB of header files. Those could get purged downstream if you knew you were never going to compile or update. Though if that was the case you could delete a whole lot more than that.
  • You could remove linux-api-headers and get 3.3MB of space there but you would have to remember to re-install before any builds.
  • One could remove the licenses package and get 1 MB. (ie: zip it up. Upload it and provide a link). I didn't mess with this for obvious reasons.
  • glibc is a monster. You could look into using musl but in this case you should probably just use Alpine Linux
  • /var/lib/pacman/local has 2.5MB in it that could be purged and restored with this script
Docker Pull Command