gmeligio/flutter-android repository overview

⁠Flutter Docker Image

Minimal Docker images for building Flutter apps in Continuous Integration (CI), for Android, Web, and Windows platforms, with the SDK and toolchain predownloaded so flutter runs without extra downloads. Images track the Flutter stable channel and the current version is 3.44.9.

docker run --rm -it ghcr.io/gmeligio/flutter-android:3.44.9 flutter build apk

Each image is tagged with the Flutter version it ships (:3.44.9), there is no latest tag (see more on the why⁠). All tools running in the image have analytics disabled and opt-in with ENABLE_ANALYTICS=true, and a rootless flutter:flutter user.

config/version.json⁠ contains the versions of the tools included in the images like Android SDK, Fastlane and Windows toolchain.

⁠Registries

Every image is published to three registries:

⁠Running on CI

The Linux images (flutter-android, flutter-web) run as the job container:

jobs:
  build:
    runs-on: ubuntu-22.04
    container:
      image: ghcr.io/gmeligio/flutter-android:3.44.9
    steps:
      - name: Checkout
        uses: actions/checkout@v4
      - name: Build
        run: flutter build apk

For flutter-web, use the same workflow with image: ghcr.io/gmeligio/flutter-web:3.44.9 and run: flutter build web. Windows containers cannot run under the Linux container: field, so flutter-windows runs on a windows-2025 runner and invokes docker directly:

jobs:
  build:
    runs-on: windows-2025
    steps:
      - name: Checkout
        uses: actions/checkout@v4
      - name: Build
        run: docker run --rm -v ${{ github.workspace }}:C:\app -w C:\app ghcr.io/gmeligio/flutter-windows:3.44.9 flutter build windows

See example workflows for GitHub Actions, GitLab CI, Gitea, and Forgejo in examples/⁠.

⁠More

• Building the images locally⁠
• FAQ⁠
• Contributing⁠

⁠License

Flutter is licensed under BSD 3-Clause "New" or "Revised" license⁠.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.

The sources⁠ for producing these Docker images are licensed under MIT License⁠.