This page contains information on how to prepare the development environment before enabling a video call with the Agora Web SDK.


  1. Install a browser supported by the Agora Web SDK as shown in the following table:
    Platform Chrome 58+ Firefox 56+ Safari 11+ Opera 45+ QQ Browser Latest 360 Security Browser Wechat Built-in Browser
    Android 4.1+ N/A
    iOS 11+
    macOS 10+
    Windows 7+ N/A

Agora Web SDK 2.5 also supports Chrome 49 on Windows XP.

  1. Open the ports and whitelist the domains as specified in Firewall Requirements.
  2. Understand the limitations in Known Issues and FAQ.

Create an Agora Account and Get an App ID

  1. Sign up for a developer account at

  2. Click Add New Project on the Projects page of Dashboard.

  3. Fill in the Project Name and click Submit. You have created your first project at Agora.

  4. Find the App ID under the created project.


Import the Agora Web SDK to Your Project

Choose one of the following methods to obtain the Agora Web SDK:

Method 1: Get the SDK through npm

This method requires npm, see Install npm for details.

  1. Run the following command to install the SDK.
    npm install agora-rtc-sdk
  1. Add the following code to your project.

     import AgoraRTC from 'agora-rtc-sdk'

Method 2: Get the SDK through the CDN

Add the following code to the line above </body> in your project.

    <script src=""></script>

Method 3: Get the SDK from the official Agora website

  1. Download the latest Agora Web SDK.

  2. Copy the AgoraRTCSDK-2.5.0.js file to your project.

  3. Reference the AgoraRTCSDK-2.5.0.js file in your project.


The screenshots are for reference only, please use the latest version of the SDK.

Preparing the Web Server

  1. Install a web server, such as Apache, Nginx, or Node.js.
  2. Import the downloaded Agora Web SDK to your web server.
  3. Set up your web server so that you can access the sample app page or your own app page on the supported browsers, see Prerequisites.

Next Steps

You have now set up the environment and can start a call/live broadcast following the steps under Quickstart Guide:

  • Initialize the SDK
  • Join a Channel
  • Publish and Subscribe to Streams