ARM64 Support

With version 0.13, LocalStack officially publishes a . This manifest contains links to a Linux AMD64 as well as a Linux ARM64 image.

Experimental

The ARM64 image of LocalStack is still experimental. Help us getting aware of current issues with the ARM64 image by if you experience any problems.

Currently known limitations are collected in the GitHub issue localstack/localstack#4921.

With the multi-arch Docker manifest, your Docker client (and therefore the ) now automatically selects the image according to your platform:

You can check the architecture of the pulled image by using :

  1. $ docker inspect localstack/localstack | jq '.[0].Architecture'
  2. "arm64"

If you want to execute Docker Lambda functions or binaries which have not been built for your architecture, you need to configure cross-platform emulation on your system.

Affects host system

The following command installs additionals emulators on your host system.

You can check the current status with:

  1. $ docker run --privileged --rm tonistiigi/binfmt
  2. {
  3.     "linux/amd64",
  4.     "linux/arm64",
  5.     "linux/386"
  6.   ],
  7.   "emulators": [
  8.     "jar",
  9.     "llvm-12-runtime.binfmt",
  10.     "python3.10",
  12.     "qemu-aarch64"
  13.   ]
  14. }

Unsupported

Please be aware that this workaround is not supported by LocalStack at all.

If you want to use a LocalStack image which has been built for another architecture than yours, you can instruct Docker to use another platform by setting the DOCKER_DEFAULT_PLATFORM environment variable:

When using Docker Compose, you can use the platform element as described in the specification.

If you are experiencing issues with the ARM64 image (and after you created an issue to make us aware of the problem 😉), you can try to use the AMD64 packages on your Apple Silicon device and use Apple Rosetta to emulate the AMD64 / x86_64 CPU architecture.

Unsupported

First, you should enable “Rosetta” on your preferred terminal. This way you’ll be installing packages for x86_64 platform.

What we will be doing now is installing Java and Python executables using Homebrew, it should automatically resolve packages to proper architecture versions.

  1. # Install Homebrew
  2. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  4. brew install java11
  6. # Install jenv and follow instructions
  7. brew install jenv
  9. # Add Java11 to jenv and use it globally
  10. jenv add /Library/Java/JavaVirtualMachines/openjdk-11.jdk/Contents/Home/
  11. jenv global 11
  13. # Install pyenv and follow instructions
  14. brew install pyenv
  16. # Install python 3.8.10 and enable it globally
  17. pyenv install 3.8.10
  18. pyenv global 3.8.10

Then clone LocalStack to your machine, run make install and then make start.

Note on JVM Lambda

You need to use the local lambda executor for JVM Lambda functions.

If you want to run LocalStack on your Raspberry Pi, make sure to use a 64bit operating system. In our experience, it works best on a Raspberry Pi 4 8GB with .