Skip to content

Local Environment

aeproject env

The command is responsible for setting up a healthy local environment. The env command helps developers run a local node and a local compiler in dev-mode using docker. To spawn a fully functional environment it can take a couple of minutes depending on your system.

If using Windows, WSL 2 needs to be used for AEproject to work normally, see https://docs.microsoft.com/en-us/windows/wsl/tutorials/wsl-containers

You can stop both the node and the compiler by running

aeproject env --stop

There are optional parameters --nodeVersion and --compilerVersion. To specify a specific version of node or compiler, or both

aeproject env --nodeVersion v7.2.0
# or
aeproject env --compilerVersion v8.0.0
# or
aeproject env --nodeVersion v7.2.0 --compilerVersion v8.0.0

This also applies to the commands aeproject node and aeproject compiler.

To see whether you have running instances of the nodes along with a compiler you could run the following command

aeproject env --info

Note: By default AEproject uses the latest-bundle tag of the official docker images.

Compatibility:

  • the sdk from @aeternity/aepp-sdk@14 >= v14.0.0 is compatible with NODE_TAG >= v7.1.0 and COMPILER_TAG >= v8.0.0
  • due to a bug in the devmode plugin, NODE_TAG = v7.1.0 is not compatible with aeproject

Disclaimer

  • Firewalls and any other security feature can block your docker/docker-compose requests. Please check that docker/docker-compose is NOT in its blocked list or has permission to make requests.