Skip to content

Latest commit

 

History

History
110 lines (83 loc) · 2.61 KB

cloud-manual-start.md

File metadata and controls

110 lines (83 loc) · 2.61 KB

VibeSurf Cloud Deployment Guide

Quick Start

Run the setup script on your cloud server (Ubuntu/Debian):

curl -fsSL https://raw.githubusercontent.com/vibesurf-ai/VibeSurf/main/scripts/setup-vibesurf-cloud.sh | sudo bash

Or download and run manually:

wget https://raw.githubusercontent.com/vibesurf-ai/VibeSurf/main/scripts/setup-vibesurf-cloud.sh
sudo bash setup-vibesurf-cloud.sh

Start VibeSurf

Option 1: Foreground (for debugging)

start-vibesurf-gui

Then in another terminal:

# Set display and input method environment variables
export DISPLAY=:99
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx
export DBUS_SESSION_BUS_ADDRESS=unix:path=/var/run/dbus/session_bus_socket

# Find browser path
export BROWSER_EXECUTION_PATH=$(find ~/.cache/ms-playwright -name chrome -type f 2>/dev/null | head -1)

# Start vibesurf
vibesurf --no_select_browser --host 0.0.0.0

Option 2: Background (recommended for servers)

# Start GUI environment in background
# Note: VIBESURF_NO_CLEANUP=1 prevents cleanup when parent shell exits
VIBESURF_NO_CLEANUP=1 nohup start-vibesurf-gui > /var/log/vibesurf-gui.log 2>&1 &

# Wait for Xvfb to be ready
sleep 5

# Start vibesurf with input method support
export DISPLAY=:99
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx
export DBUS_SESSION_BUS_ADDRESS=unix:path=/var/run/dbus/session_bus_socket
export BROWSER_EXECUTION_PATH=$(find ~/.cache/ms-playwright -name chrome -type f 2>/dev/null | head -1)
nohup vibesurf --no_select_browser --host 0.0.0.0 > /var/log/vibesurf.log 2>&1 &

Access VibeSurf

Customization

# Custom VNC password
VNC_PASSWORD=yourpassword start-vibesurf-gui

# Custom resolution
RESOLUTION=1920x1080x24 start-vibesurf-gui

# Custom ports
VNC_PORT=5902 NOVNC_PORT=6081 start-vibesurf-gui

Troubleshooting

Xvfb not starting

# Check if Xvfb is running
ps aux | grep Xvfb
xdpyinfo -display :99

# If failed, try different display
Xvfb :100 -screen 0 1440x900x24 -ac +extension GLX +render -noreset &
export DISPLAY=:100

Browser not found

# Install Playwright browsers manually
python3 -m playwright install chromium --with-deps

# Or find existing browser
find /ms-browsers ~/.cache/ms-playwright -name "chrome" 2>/dev/null | head -1

Port already in use

# Kill existing processes
pkill -9 Xvfb
pkill -9 x11vnc
pkill -f novnc_proxy