RamNode logo
    Sign UpLogin
    AI Development Platform

    Deploying Dyad.sh on RamNode VPS

    Dyad.sh is a free, local, open-source AI app builder that serves as an alternative to cloud-based solutions. Build full-stack applications using AI while maintaining complete control over your code and data on RamNode's reliable VPS hosting.

    Ubuntu 22.04/24.04 LTS
    Multi-AI Support
    ⏱️ 30-45 minutes

    Key Features

    Local-first Architecture

    Fast, private, and no vendor lock-in

    Bring Your Own API Keys

    Works with OpenAI, Anthropic, Google Gemini, and Ollama

    Supabase Integration

    Built-in auth, database, and serverless functions

    Git-based Versioning

    Every edit is tracked with instant undo capability

    Prerequisites

    Recommended VPS Specifications

    ComponentRequirement
    Operating SystemUbuntu 22.04 or 24.04 LTS
    RAMMinimum 4GB (8GB+ for Ollama)
    Storage20GB+ SSD
    CPU2+ vCPUs (4+ recommended)

    Required Software

    • Node.js 18.x or later
    • npm or pnpm package manager
    • Git version control
    • Desktop environment or X11 forwarding
    • AI API key (OpenAI, Anthropic, or Google)

    Step 1: Initial Server Setup

    1

    Connect and Update System

    Connect to your VPS and update the system:

    SSH & Update
    ssh root@your-server-ip
apt update && apt upgrade -y

    Create a non-root user (recommended):

    Create User
    adduser dyad
usermod -aG sudo dyad
su - dyad

    Step 2: Install Dependencies

    2

    Install Build Tools & Node.js

    Install essential build tools:

    Build Tools
    sudo apt install -y build-essential curl wget git

    Install Node.js 20.x LTS:

    Install Node.js
    curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

    Verify installation:

    Verify
    node --version
npm --version

    Install pnpm (recommended by Dyad):

    Install pnpm
    npm install -g pnpm

    Step 3: Set Up Desktop Environment

    Note: Dyad is an Electron-based desktop application. You have several options for running it on a VPS.

    Step 4: Download and Install Dyad

    4

    Download Dyad AppImage

    Download the latest Linux AppImage from GitHub:

    Download Dyad
    mkdir -p ~/Applications && cd ~/Applications
wget https://github.com/dyad-sh/dyad/releases/latest/download/Dyad-linux-x86_64.AppImage
chmod +x Dyad-linux-x86_64.AppImage

    Enable AppImage support:

    Enable FUSE
    sudo apt install -y fuse libfuse2

    Step 5: Configure and Launch Dyad

    5

    Launch Dyad

    Launch Dyad:

    Launch
    ./Dyad-linux-x86_64.AppImage

    For X11 forwarding from your local machine:

    X11 Forwarding
    ssh -X dyad@your-server-ip
cd ~/Applications && ./Dyad-linux-x86_64.AppImage

    Initial Configuration

    1. Complete the Node.js setup if prompted
    2. Navigate to Settings and configure your AI API keys
    3. Choose your preferred AI model
    4. (Optional) Connect your GitHub account for deployment

    AI Provider Options

    ProviderRecommended ModelNotes
    Google GeminiGemini 2.5 Flash/ProFree tier: 250 msg/day
    AnthropicClaude Sonnet 4.5Excellent for code
    OpenAIGPT-4.1Strong general purpose
    Ollama (Local)Llama 3.1Free, needs 8GB+ RAM

    Step 6: Optional - Set Up Ollama for Local AI

    6

    Install Ollama

    For completely private, offline AI generation:

    Install Ollama
    curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.1:8b
ollama list

    In Dyad settings, select Ollama as your provider and choose your model.

    Step 7: Running Dyad Apps as Services

    7

    Export and Deploy Your App

    Export and run your Dyad-built app:

    Build App
    cd ~/dyad-apps/your-app-name
pnpm install
pnpm run build

    Create a systemd service file:

    Create Service
    sudo nano /etc/systemd/system/dyad-app.service

    Add the following configuration:

    Service Configuration
    [Unit]
Description=Dyad Application
After=network.target

[Service]
Type=simple
User=dyad
WorkingDirectory=/home/dyad/dyad-apps/your-app-name
ExecStart=/usr/bin/node dist/index.js
Restart=on-failure
Environment=NODE_ENV=production
Environment=PORT=3000

[Install]
WantedBy=multi-user.target

    Enable and start the service:

    Enable Service
    sudo systemctl daemon-reload
sudo systemctl enable dyad-app
sudo systemctl start dyad-app
sudo systemctl status dyad-app

    Step 8: Configure Nginx Reverse Proxy

    8

    Set Up Nginx with SSL

    Install Nginx:

    Install Nginx
    sudo apt install -y nginx

    Create Nginx configuration:

    Create Config
    sudo nano /etc/nginx/sites-available/dyad-app

    Add the following:

    Nginx Configuration
    server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

    Enable the site and restart Nginx:

    Enable Site
    sudo ln -s /etc/nginx/sites-available/dyad-app /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

    Add SSL with Certbot (Recommended):

    Install SSL
    sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com

    Troubleshooting

    Additional Resources

    Dyad Official WebsiteDyad DocumentationGitHub RepositoryRamNode Support

    Ready to Build with Dyad?

    Get started with a RamNode Cloud VPS and have your self-hosted AI app builder running in no time. Start with Google Gemini's free tier, then upgrade to Claude or GPT-4 for production.

    View Cloud VPS PlansMore Deployment Guides