Learn how to run EAS Build on your own custom infrastructure.
You can run the same build process that we run on the EAS Build servers directly on your machine with the --local
flag.
eas build --platform android --local
# or
eas build --platform ios --local
Note: if you use Continuous Native Generation, you can run prebuild to generate your android and ios directories and then proceed open the projects in the respective IDEs and build them just like any native project. It's not necessary to run
eas build --local
, but it handles more of the build process for you — see "Use cases for local builds".
You need to be authenticated with Expo:
eas login
,EXPO_TOKEN
(learn more about token-based authentication).@account/slug
existsIf you encounter build failures on EAS servers and you're unable to determine the cause from inspecting the logs, you may find it helpful to debug the issue locally. To simplify that process we support a number of environment variables to configure the local build process.
EAS_LOCAL_BUILD_SKIP_CLEANUP=1
- Set this to disable cleaning up the working directory after the build process is finished.EAS_LOCAL_BUILD_WORKINGDIR
- Specify the working directory for the build process, by default it's somewhere (it's platform dependent) in /tmp
folder.EAS_LOCAL_BUILD_ARTIFACTS_DIR
- The directory where artifacts are copied after a successful build. By default these files are copied to the current directory, which may be undesirable if you are running many consecutive builds.Some of the options available for cloud builds are not available locally. Limitations you should be aware of:
all
is disabled).node
, yarn
, fastlane
, cocoapods
, ndk
, image
in eas.json are ignored.