📂 API Providers > Build an Airnode

# Deploying Airnode

Table of Contents

After integrating your API (API Integration) and creating the configuration files (Configuring Airnode), the next step is to deploy the Airnode.

Complete the following before deploying your Airnode.

# Deploy with Docker

The recommended way to deploy Airnode is by using the Docker deployer image. This image is simply a wrapper around the deployer CLI (opens new window). Try out the Quick Deploy tutorial if you wish to become familiar with the deployer image first.

The deployer interacts with a cloud provider to deploy Airnode programmatically, without requiring you to click through a lot of ever-changing graphical interfaces. For it to do so, a cloud project setup and credentials are required and was discussed in Configuring an Airnode.

# Install Docker

The deployer image is containerized as a Docker image. This will deploy the Airnode to the cloud provider without the worry of installing dependencies and is the recommended way to do a deployment. If you do not already have docker installed go to the Docker website (opens new window) and install it.

# Deployment

At this point your project should resemble the following. The config.json, secrets.env, aws.env (if deploying to AWS) and gcp.json (if deploying to GCP) files should be ready to go. Other files you may have added are expected but not used by the deployer image.

Warning about simultaneous deployments

Avoid running multiple deployments simultaneously as doing so might result in a broken deployment. If this occurs, the standard removal approach may not succeed and Manual Removal may be required.

From the root of the project directory run the Docker image command deploy as shown below to deploy the Airnode. When the deployment has completed a receipt.json file will be written to your current working directory, which is mounted to the /app/config directory within the container. This file contains important configuration information about the Airnode and is needed to remove the Airnode should the need arise.

Normally (for Linux/Mac/WSL2) the deployer image deploy command is run by the user root. This may cause permission issues when the receipt.json file is generated. Optionally you can specify the UID (user identifier) and GID (group identifier) that the deployer image should use. Do so by setting the environment variables USER_ID and GROUP_ID, otherwise omit the line containing the variables.

# receipt.json

The receipt.json file is a product of a deployment attempt. It contains Airnode configuration and deployment information and is used to remove the Airnode. The field success is important in that it specifies whether the deployment was successful or not.

{
  "airnodeWallet": {
    "airnodeAddress": "0xaBd9daAdf32fCd96eE4607bf3d5B31e19a244Cac",
    "xpub": "xpub661MyMwAqRbcGHp9uC7...vbeziJwFHuNs"
  },
  "deployment": {
    "deploymentId": "aws8fd2e911",
    "cloudProvider": {
      "type": "aws",
      "region": "us-east-1"
    },
    "stage": "dev",
    "nodeVersion": "0.10.1",
    "timestamp": "2022-03-26T02:37:55.506Z"
  },
  "success": true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# Testing with HTTP Gateway

If you opted to enable the HTTP Gateway it can be used to test the Airnode while bypassing the chain it was deployed to. There are three examples in other docs that detail how to do this.

# Calling the Airnode

Once the Airnode is deployed, see Calling an Airnode to learn how requests are made to it.

# Removing the Airnode

If you would like to remove a deployed Airnode, see the Docker image commands for remove or remove-with-receipt instructions.

Last Updated: 4/12/2023, 4:36:21 AM