ScreenerBot
DocsGetting StartedInstallation GuideVPS / Server
ScreenerBot
ScreenerBot

Need Help?

Join our community for support, updates, and trading discussions.

Telegram ChannelTelegram GroupFollow on X (Twitter)Contact Support
Installation/VPS

VPS Installation

Run ScreenerBot on a Linux VPS or dedicated server for 24/7 automated trading. One command to install, interactive menu for management, and built-in monitoring.

24/7 Uptime

Never miss trading opportunities. Your bot runs continuously without depending on your local machine.

Low Latency

VPS providers often have better network connectivity and lower latency to Solana RPC endpoints.

Reliability

Enterprise-grade infrastructure with power backup and redundant network connections.

VPS Requirements

Recommended VPS Specs

  • OS: Ubuntu 22.04 LTS or Debian 12 (recommended)
  • CPU: 2+ vCPUs (4+ recommended)
  • RAM: 4 GB minimum (8 GB recommended)
  • Storage: 20 GB SSD
  • Architecture: x64 or ARM64

Popular providers: DigitalOcean, Vultr, Linode, Hetzner, AWS EC2

Installation Methods

Choose any of these methods to install ScreenerBot. All methods download the same open-source management script.

One-Command Install

Recommended — uses our shortcut URL

curl -fsSL https://screenerbot.io/install.sh | bash

This is the easiest method. The script will guide you through installation interactively.

Via jsDelivr CDN

Fast global CDN delivery with caching

curl -fsSL "https://cdn.jsdelivr.net/gh/screenerbotio/Public@main/screenerbot.sh" | bash

Direct from GitHub

Direct download from repository

bash <(curl -fsSL https://raw.githubusercontent.com/screenerbotio/Public/main/screenerbot.sh)
View Script Source on GitHub

Script is Open Source

The installation script is fully open source. We encourage you to review the code before running. It's a single bash script that handles installation, updates, backups, and service management.

What the Installer Does

  • Auto-detects architecture (x64/arm64)
  • Downloads latest headless package from API
  • Installs binary to /opt/screenerbot
  • Creates systemd service with auto-restart
  • Enables auto-start on boot
  • Creates screenerbot command symlink
  • Verifies binary checksum
  • Self-updates the management script

Interactive Management Menu

After installation, run screenerbot-manager anytime to access the interactive management menu with live system stats.

Menu Features

Installation

  • •Install — Download and install ScreenerBot
  • •Update — Check for updates and install latest version
  • •Reinstall — Fresh install (keeps data)
  • •Uninstall — Remove ScreenerBot completely

Service Control

  • •Start/Stop/Restart — Manage systemd service
  • •View Logs — Live log streaming
  • •Enable/Disable — Auto-start on boot

Data Management

  • •Backup — Create compressed backup of all data
  • •Restore — Restore from backup file

Monitoring & Security

  • •System Monitor — Live CPU, RAM, disk, network stats
  • •Dashboard Security — Set password/TOTP protection
  • •Status & Info — Detailed installation info

Notifications

  • •Telegram Alerts — Get notified of new releases
  • •System Check — Verify installation health

Script Updates

  • •Self-Update — Update management script itself
  • •Auto-Check — Checks for updates on startup

Live Stats Dashboard

The main menu shows real-time system and bot information:

System Stats

  • • CPU usage with visual bar
  • • Memory usage with visual bar
  • • Disk usage with visual bar
  • • System load average
  • • Server uptime

Bot Stats (when running)

  • • Service status (running/stopped)
  • • Installed version
  • • Process ID and memory usage
  • • Wallet balance (SOL)
  • • Trading status and positions

Command Line Usage

For automation and scripting, you can use direct commands instead of the interactive menu:

CommandDescription
screenerbot-managerInteractive menu (default)
screenerbot-manager installInstall latest version
screenerbot-manager install 0.1.107Install specific version
screenerbot-manager updateCheck and install updates
screenerbot-manager statusShow installation status
screenerbot-manager start/stop/restartControl the service
screenerbot-manager logsView live logs (last 50 lines + follow)
screenerbot-manager monitorLive system monitor
screenerbot-manager backupCreate data backup
screenerbot-manager restore [file]Restore from backup
screenerbot-manager uninstallRemove ScreenerBot
screenerbot-manager self-updateUpdate management script
screenerbot-manager helpShow all commands

Accessing the Dashboard

The dashboard runs on port 8080. You have several options to access it:

Option A: SSH Tunnel (Recommended)

Most secure - keeps the dashboard accessible only via SSH:

ssh -L 8080:localhost:8080 user@your-vps-ip

Then open http://localhost:8080 in your browser.

Option B: Reverse Proxy (nginx)

For public access with HTTPS. Requires a domain and SSL certificate.

server {
    listen 443 ssl;
    server_name bot.yourdomain.com;
    
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
    }
}

Security Warning

Never expose port 8080 directly to the internet without authentication. The dashboard has access to your trading controls. Use the Dashboard Security option in the management menu to set up password and TOTP protection.

File Locations

  • •
    Binary: /opt/screenerbot/screenerbot
  • •
    Command Symlink: /usr/local/bin/screenerbot
  • •
    Data Directory: ~/.local/share/ScreenerBot/data/
  • •
    Log Files: ~/.local/share/ScreenerBot/logs/
  • •
    Service File: /etc/systemd/system/screenerbot.service
  • •
    Manager Script: /usr/local/bin/screenerbot-manager (optional)

Direct systemctl Commands

If you prefer using systemctl directly instead of the management menu:

  • sudo systemctl status screenerbot — Check service status
  • sudo systemctl start screenerbot — Start the bot
  • sudo systemctl stop screenerbot — Stop the bot
  • sudo systemctl restart screenerbot — Restart the bot
  • sudo systemctl enable screenerbot — Enable auto-start
  • sudo systemctl disable screenerbot — Disable auto-start
  • journalctl -u screenerbot -f — View live logs

Firewall Configuration

Configure UFW to secure your VPS:

sudo ufw allow sshsudo ufw allow 443/tcp # Only if using reverse proxysudo ufw enable

⚠️ Do NOT open port 8080 directly unless you've configured authentication.

Telegram Integration

For VPS deployments, we highly recommend setting up Telegram integration. This gives you real-time notifications and control without needing to access the dashboard.

Set up Telegram Integration

Next Steps

VPS Setup Complete!

ScreenerBot is now running 24/7 on your VPS. Complete the initial configuration:

1

Initial Setup

Configure wallet & RPCs

2

Telegram Setup

Remote monitoring & control

Linux Installation
Previous

Desktop Linux installation

Initial Setup
Next

Configure wallet and RPCs