# earthly/earthly

Super simple build framework with fast, repeatable builds and an instantly familiar syntax – like Dockerfile and Makefile had a baby.

Repository: https://github.com/earthly/earthly
Canonical: https://ross.abutalabs.com/products/earthly
Homepage: https://earthly.dev
Language: Go
License: MPL-2.0
License Family: copyleft
Topics: build-automation, build, container-builder, hacktoberfest, docker-images, hacktoberfest2020, reproducible-builds, dockerfiles, hacktoberfest2021, build-tool, build-system, ci, ci-cd, cicd, framework
Last push: 2025-10-23T20:10:46+00:00

## Health v2 (maintenance only)
Score: 44/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 48, release rhythm 8, longevity 100
- inputs: {"age_days": 2365, "days_push": 314, "days_rel": 413, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 12047, forks 458 (observed 2026-08-28T04:10:51.483886+00:00)

## What it is
Earthly is a CI/CD build framework that runs every build step inside containers, using an Earthfile syntax that combines Dockerfile and Makefile conventions. It enables repeatable, cached, parallel builds that run identically on a laptop, remotely, or in any CI system, and works with any language or build tool that runs on Linux.

## Use cases
- write repeatable containerized builds that run the same locally and in CI
- replace bash and yaml spaghetti in CI pipelines
- build docker images and artifacts with a makefile-like syntax
- speed up builds with caching and parallel execution
- share and reuse build logic across a monorepo
- run CI pipelines on a laptop before pushing code
- integrate a consistent build layer on top of GitHub Actions, GitLab CI, Jenkins, or CircleCI

## When to choose
- you want consistent, containerized builds across local development and CI
- your team struggles with duplicated, environment-dependent build scripts
- you need a language-agnostic build layer that augments existing tools like maven, npm, or go build
- you want fast builds via automatic caching and parallelism

## When to avoid
- you need a build tool with active long-term maintenance and vendor support - Earthly is no longer actively maintained
- you want a fully managed hosted CI service rather than a build framework layered on existing CI
- your builds cannot run inside Linux containers
- you prefer native CI YAML without an additional build abstraction layer

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: build-tool, ci-cd, container-runtime, deployment, developer-tools
- domain: developer-tools, cloud-computing
- platform: windows, go, cli, cross-platform
- tags: earthfiles, reproducible-builds, dockerfile-like-syntax, monorepo, build-caching, containerized-builds, ci-integration, no-longer-maintained, devops, containers, automation, linux, macos, docker

## Member repositories
- earthly/earthly (main) score 44

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:51.483886+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:14:58.746448+00:00, confidence not recorded.
  - readme: https://github.com/earthly/earthly (fetched 2026-08-28T04:10:51.483886+00:00, sha 6d3036b9afe6)
  - homepage: https://earthly.dev (fetched 2026-08-29T08:12:40.239083+00:00, sha b67d5f754a4e)
  - site_page: https://docs-lunar.earthly.dev/ (fetched 2026-08-29T08:12:40.248696+00:00, sha cc7707d75f8a)
  - site_page: https://docs-lunar.earthly.dev (fetched 2026-08-29T08:12:40.252824+00:00, sha cc7707d75f8a)
  - site_page: https://earthly.dev/about (fetched 2026-08-29T08:12:40.254605+00:00, sha 2e05fbf5cf2f)
  - site_page: https://docs.earthly.dev/ (fetched 2026-08-29T08:12:40.258201+00:00, sha 307b3efe380d)
  - site_page: https://earthly.dev/lunar/integrations (fetched 2026-08-29T08:12:40.250644+00:00, sha 4b86fc18ab1e)
  - site_page: https://earthly.dev/earthfile (fetched 2026-08-29T08:12:40.256529+00:00, sha 4aee8260d937)
- Data as of 2026-08-30T08:39:29.467469+00:00.