Skip to content
Build And Testing Environments as Code Tool
Kotlin Python Shell Groovy PowerShell Dockerfile Other
Branch: master
Clone or download
charleskorn Merge pull request #404 from batect/dependabot/gradle/app/org.araqnid…

Bump hamkrest-json from 1.1.0 to 1.1.2 in /app
Latest commit 64e69f5 Feb 18, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
.dependabot Correctly tag Dependabot PRs. Jan 21, 2020
app Bump hamkrest-json from 1.1.0 to 1.1.2 in /app Feb 18, 2020
buildSrc Update copyright year to 2020. Jan 2, 2020
docs Fix linting issue. Feb 16, 2020
gradle Switch to Bintray organisation for releases. Feb 16, 2020
tools Add the ability to override the health check command for a container. Feb 16, 2020
travis Update project URL. Jan 19, 2020
wrapper Switch to Bintray organisation for releases. Feb 16, 2020
.codecov.yml Tweak code coverage thresholds. Aug 1, 2019
.editorconfig Add wrapper script for Windows. Jul 20, 2019
.gitattributes Fix issue with symlinks journey test in Windows build. Jul 26, 2019
.gitignore Move Unix wrapper script project to its own directory. Jul 7, 2019
.travis.yml Only wait on Travis for Windows build to complete if we're about to p… Feb 16, 2020 Update documentation site URL. Jan 19, 2020
LICENSE Switch to Bintray organisation for releases. Feb 16, 2020 Update documentation to include references to Windows and add CLI ref… Jul 22, 2019 Fix formatting issue in security policy. Aug 24, 2019
build.gradle Bump com.diffplug.gradle.spotless from 3.27.0 to 3.27.1 Jan 14, 2020 Format everything according to official Kotlin Coding Conventions. Oct 27, 2018
gradlew Update Gradle to 6.0.1. Nov 23, 2019
gradlew.bat Update to Gradle 5.5.1. Jul 19, 2019


Build Status Coverage License Chat

build and testing environments as code tool: Dockerised build and testing environments made easy

The sales pitch

  • Consistent, fast, repeatable, isolated builds and test runs everywhere: your computer, your colleagues' computers and on CI
  • Document and share common tasks within your team in a structured way - it's a go script based on Docker
  • Manage dependencies for integration and end-to-end testing (like databases) with ease
  • Onboard new team members in minutes: no installation required
  • Supports Linux, OS X and Windows
  • Works with any language or framework, your existing CI system, and your chosen language's existing tooling
  • Take advantage of existing Docker images to get started quickly


Getting started

  1. Drop the latest batect and batect.cmd scripts from the releases page into the root folder of your project.
  2. If you're on Linux or OS X, make sure the script is executable: run chmod +x batect.
  3. Create your batect.yml to define your environment:

System requirements

batect requires Docker 18.03.1 or newer, Java 8 or newer (although this requirement will be removed before v1.0), and:

  • On Linux and OS X: Bash and curl
  • On Windows: Windows 10

batect supports both Linux and Windows containers.


All documentation is available on the documentation site. Highlights include:

If you prefer watching videos to reading documentation, you can also watch Charles introduce batect and the rationale behind it at the Evolution by ThoughtWorks conference.

Support and community

There's a batect community on Spectrum - anyone is welcome to join.


Please open an issue on GitHub if you run into a problem or have a suggestion.

You can see what new features and improvements are planned in the roadmap.


Thank you to the following people for their bug reports, pull requests, suggestions and feedback, in alphabetical order:

Thank you to YourKit for providing a complimentary copy of the YourKit profiler, and thank you to JFrog for providing a complimentary instance of both Bintray and Artifactory.

You can’t perform that action at this time.