Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Android Docker

Dockerfile for building Android projects inside a container. Contains Android SDK and NDK. Based on Ubuntu LTS for maximum compatiblity.


Video Tutorial

I did some of the development work of this project live for a YouTube tutorial on how to use GitHub for open source projects. It also demonstrates how to use this project to build a sample Android app from source. If you want to see it, you can watch it here:


Following commands assume that your project source code is at /build directory of this repo, and your project's Gradle wrapper executable is located at /build/gradlew. Alternatively, you can adjust $(pwd)/build in the second command to point to your Android project source.

Build the Docker image first. Skip this step if you want to use the Docker Hub image:

docker build -f docker/Dockerfile -t soygul/android-docker .

Now build the Android project using Gradle wrapper:

docker run -it --rm -v $(pwd)/build:/root/build soygul/android-docker ./gradlew build

After a successful build, all build artficats will be in their respective locations as if you built the project natively on your computer.

Android SDK/NDK and Build Tools Versions

By default, this image uses the latest version of Android SDK/NDK and Android Build Tools. If you need a different versions, change them accordingly in the Dockerfile and rebuild the image using the commands given above.


It's best to use a device farm to test your app on real devices, i.e. Firebase Test Lab However if you want to test your app in an emulator inside a container, check the following resources:

Security Note

While building the image, Dockerfile scripts only have access to files residing in the /docker directory for security reasons. If you need any file from /build directory during image build, you should copy them to /docker directory. Note that this is only true during image building process. Running container will have full access to /build directory.


Build your Android projects inside Docker containers.




No releases published


No packages published