Skip to main content

Run dApps on Iagon Compute

dApps on Compute Node

Introducing Iagon Compute, a platform tailored to support applications deployed by compute subscribers on the Iagon decentralized compute network. Presently, our platform specifically caters to NodeJS applications.

Requirements for Running dApps

  • Must be an Iagon app user
  • The app must be a Node.js application (Tested for all LTS versions of Node.js: 16, 18, and 20.)
  • The app must have a public Git repository
  • You should specify the port your app will be listening on.
    Usually, you can find this information in the index.js file of your application, resembling:
    app.listen(3000, '', function ()

Here, '3000' represents the port number, and '' stands for the host.
Please input the same values from your code into the form.

  • The app should include build and start commands in the package.json file.
    Build command: npm run (build command you provided) (leave blank if no build is required)
    Start command: npm run (start command you provided)

Please ensure your code resembles the following structure in your package.josn:


"scripts": {
"start": "node index.js"

  • You should provide any environment variables used by the app
  • Only public repositories are supported
  • Only Node.js apps are supported (Tested for all LTS versions of Node.js: 16, 18, and 20.)

Technical Details

  • Each dApp runs inside its own isolated environment. Isolation is achieved by creating a new VM for each app using the KVM hypervisor.

How to run dApps

To run dApp, navigate to and go to the web host section. In the "dApps" menu, click the "Add dApp" button to deploy your app to the Iagon network. Upon deployment, you will receive a domain URL for your app.

Additional Instructions

Follow these steps for deploying your dApp with screenshots for guidance:

Click Webhost, view dApps

  • Click on Webhost, dApps menu should be displayed

If we haven't subscribed to storage, we can only view the dApps hosting option.


Click dApps (Launch page if no dApp)

  • Click on dApps menu (Launch page should be displayed if dApp has not been added yet)


Click Run App (List of dApps)

  • Click on dApps menu (List of added dApp should be displayed with its proper data and status with button to add dApp)


Click Add dApp (Clear node status)

  • Click on the Add Website button (All the nodes status should be deleted before adding new one)


Choose subscription plan

  • Form should be displayed to enter details to choose subscription plan

Choose Subscription Plan

Subscription payment

  • Sign the transaction to pay for the subscription.


Choose paid available plans

  • Choose from the available paid plans to host your dApp.


Enter app details

  • Form should be displayed to enter details of the dApp


Fill required fields

  • Enter valid data in all the required fields as per necessity. For reference, please refer to requirements


  • For the GitHub link, please navigate to your repository's code page. Locate the "Code" button, which may be accompanied by a dropdown menu, as shown in the screenshot. Copy the GitHub repository link from there.

Please refrain from copying the URL shown in the browser's address bar.

  • Paste the copied GitHub repository link into the form.

  • Regarding the branch
    Referencing the screenshot, identify the name of the branch you are currently working on. This branch name should be added to the form accordingly. If it is the default branch, please include its name in the form.


Click Next

  • Click on the Next button after entering valid data in all required field


View deployment page

  • Another page should be displayed indicating app is being deployed


Visit button enabled

  • Visit button should be enabled after deployed is completed


App list shows "Running"

  • After added, app list should be displayed at top with "Running" status


Delete dApp (Click three dots)

  • After adding the dApp, we can delete it. Click on 3 dot button on the web


View delete success message

  • Successfully deleted message to be displayed


View dApps Dashboard


View dApps Log