Flutter Docker Image

Minimal Docker images for building Flutter apps in Continuous Integration (CI), for Android, Web, Linux, 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.47.9.

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

Each image is tagged with the Flutter version it ships (:3.47.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:

Registry	flutter-android	flutter-web	flutter-linux	flutter-windows
Docker Hub	gmeligio/flutter-android:3.47.9	gmeligio/flutter-web:3.47.9	gmeligio/flutter-linux:3.47.9	gmeligio/flutter-windows:3.47.9
GitHub Container Registry	ghcr.io/gmeligio/flutter-android:3.47.9	ghcr.io/gmeligio/flutter-web:3.47.9	ghcr.io/gmeligio/flutter-linux:3.47.9	ghcr.io/gmeligio/flutter-windows:3.47.9
Quay	quay.io/gmeligio/flutter-android:3.47.9	quay.io/gmeligio/flutter-web:3.47.9	quay.io/gmeligio/flutter-linux:3.47.9	quay.io/gmeligio/flutter-windows:3.47.9

Running on CI

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

Windows:

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.47.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.