Quick Start
Deploy your first application on EdgeRun in minutes with this step-by-step guide
Quick Start Guide
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:
- Go to the EdgeRun Dashboard
- Click "Connect Wallet" in the top right corner
- Select your preferred wallet from the list
- Approve the connection in your wallet
- Your wallet address will be displayed once connected
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:
- Navigate to the Deployments page
- Click "New Deployment"
- Fill in the deployment details:
my-first-app
nginx:latest
100m
(0.1 CPU cores)128Mi
1Gi
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
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, () => {
});
{
"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.
🎉 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