Skip to main content

Quick Start

Deploy your first application on EdgeRun in minutes with this step-by-step guide

Quick Start Guide

5 Minutes

Get your first application deployed on EdgeRun in just a few minutes. This guide will walk you through the essential steps to start using the decentralized compute platform.

Prerequisites

Before you begin, make sure you have:

💳 Crypto Wallet

MetaMask, Phantom, or any WalletConnect supported wallet

🪙 SOL Tokens

Some SOL for transaction fees (testnet SOL for development)

🐳 Docker (Optional)

For building custom container images locally

Connect Your Wallet

Start by connecting your wallet to the EdgeRun platform:

  1. Go to the EdgeRun Dashboard
  2. Click "Connect Wallet" in the top right corner
  3. Select your preferred wallet from the list
  4. Approve the connection in your wallet
  5. Your wallet address will be displayed once connected

New to crypto wallets? If you don't have a wallet yet, we recommend starting with MetaMaskfor desktop or Phantomfor mobile users.

Install EdgeRun CLI

While you can use the web dashboard, the CLI provides more advanced features:

NPM Installation (Recommended)

npm install -g @edgerun/cli

Quick Install Script

curl -sSL https://install.edgerun.tech | sh

Homebrew (macOS/Linux)

brew install edgerun/tap/edgerun

Deploy Your First Application

Deploy using the web interface:

  1. Navigate to the Deployments page
  2. Click "New Deployment"
  3. Fill in the deployment details:
Name: my-first-app
Image: nginx:latest
CPU: 100m (0.1 CPU cores)
Memory: 128Mi
Storage: 1Gi
Port: 80

Click "Deploy" and your application will be scheduled on the network!

Example: Node.js Application

Let's deploy a more complex application - a Node.js web app:

app.js
// app.js
const express = require('express');
const app = express();
const port = process.env.PORT || 3000;

app.get('/', (req, res) => {
  res.json({ 
    message: 'Hello from EdgeRun!',
    timestamp: new Date().toISOString(),
    hostname: require('os').hostname(),
    version: process.env.npm_package_version || '1.0.0'
  });
});

app.get('/health', (req, res) => {
  res.status(200).json({ status: 'healthy' });
});

app.listen(port, () => {
});
package.json
{
  "name": "my-node-app",
  "version": "1.0.0",
  "description": "Simple Express app for EdgeRun",
  "main": "app.js",
  "scripts": {
    "start": "node app.js"
  },
  "dependencies": {
    "express": "^4.18.2"
  }
}

Payment and Billing

EdgeRun uses native streaming payments on Solana for real-time billing:

⚡ Real-time Streaming

Resources are paid for second-by-second as they're consumed

🔄 Continuous Flow

No invoices or manual payments needed

📊 Automatic Adjustment

Stream rates change based on actual resource usage

Medical Research Organizations: If you're conducting medical research, you may qualify for our Medical Research Community Initiative which provides free compute resources. Academic institutions, non-profit research organizations, and healthcare foundations can apply for up to 10% of our total compute capacity at no cost.

Learn more about the Medical Research Program →

🎉 Congratulations!

You've successfully deployed your first application on EdgeRun. The platform's decentralized architecture ensures your app runs reliably across our global network of providers.

Explore Advanced Features

🌐 Custom Domains

Use your own domain names for professional deployments

🏗️ Environment Management

Separate development, staging, and production environments

⚖️ Load Balancing

Distribute traffic across multiple regions and providers

📊 Monitoring & Alerts

Set up comprehensive monitoring and alerting

🔄 CI/CD Integration

Automate deployments with GitHub Actions and GitLab CI

🔐 Security Best Practices

Implement security scanning and compliance

Common Troubleshooting