Reproducible builds with GitHub Actions
SOURCE_DATE_EPOCH is a standardized environment variable
for instructing build tools to produce a reproducible output.
Setting the environment variable for a build makes the timestamps in the
image index, config, and file metadata reflect the specified Unix time.
With Docker GitHub Builder, pass SOURCE_DATE_EPOCH as a build argument.
With individual actions, use the built-in env property on the build step.
Unix epoch timestamps
The following example sets the SOURCE_DATE_EPOCH variable to 0, Unix epoch.
Set the epoch with GitHub Builder
Pass the fixed epoch through the Build workflow:
name: ci
on:
push:
jobs:
build:
uses: docker/github-builder/.github/workflows/build.yml@v1
permissions:
contents: read
id-token: write
with:
output: image
build-args: |
SOURCE_DATE_EPOCH=0
meta-images: user/appFor the Bake workflow, set
*.args.SOURCE_DATE_EPOCH=0 using the set input.
Set the epoch with individual actions
name: ci
on:
push:
jobs:
docker:
runs-on: ubuntu-latest
steps:
- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v4
- name: Build
uses: docker/build-push-action@v7
with:
tags: user/app:latest
env:
SOURCE_DATE_EPOCH: 0name: ci
on:
push:
jobs:
docker:
runs-on: ubuntu-latest
steps:
- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v4
- name: Build
uses: docker/bake-action@v7
env:
SOURCE_DATE_EPOCH: 0Git commit timestamps
The following individual-action examples set SOURCE_DATE_EPOCH to the Git
commit timestamp. Keep timestamp generation in the caller when it depends on
a workflow step. A reusable workflow call cannot reference earlier steps in
the same job.
name: ci
on:
push:
jobs:
docker:
runs-on: ubuntu-latest
steps:
- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v4
- name: Get Git commit timestamps
run: echo "TIMESTAMP=$(git log -1 --pretty=%ct)" >> $GITHUB_ENV
- name: Build
uses: docker/build-push-action@v7
with:
tags: user/app:latest
env:
SOURCE_DATE_EPOCH: ${{ env.TIMESTAMP }}name: ci
on:
push:
jobs:
docker:
runs-on: ubuntu-latest
steps:
- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v4
- name: Get Git commit timestamps
run: echo "TIMESTAMP=$(git log -1 --pretty=%ct)" >> $GITHUB_ENV
- name: Build
uses: docker/bake-action@v7
env:
SOURCE_DATE_EPOCH: ${{ env.TIMESTAMP }}Additional information
For more information about the SOURCE_DATE_EPOCH support in BuildKit,
see BuildKit documentation.