Run dApps on Iagon Compute Testnet
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, '0.0.0.0', function ()
Here, '3000' represents the port number, and '0.0.0.0' 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 Iagon app 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 an dApps, navigate to app.stage.iagon.com 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 dApp hosting option.
Click dApp (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 dApp 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 dApp 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
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