RoostGPT Installation Guide - Ubuntu
Overview
RoostGPT is an AI-powered testing tool. This guide will help you install RoostGPT on your Ubuntu instance in just a few minutes.
Prerequisites
Before installing RoostGPT, ensure your system meets the following requirements:
| Requirement | Specification |
|---|---|
| Operating System | Ubuntu 22.04 LTS |
| Root Disk Space | Minimum 100 GB available |
| Network | Internet connection enabled |
| Permissions | sudo/root access required |
Installation Steps
Step 1: Obtain the Installer
You have two options to get the RoostGPT installer:
Option A: Download from Public Location
# Download the installer (replace URL with actual location)
wget https://your-public-location/roostgpt-installer.sh
# Or using curl
curl -O https://your-public-location/roostgpt-installer.sh
Option B: Transfer via SCP
# From your local machine, copy installer to Ubuntu instance
scp roostgpt-installer.sh ubuntu@<your-instance-ip>:~/
# Then SSH into your instance
ssh ubuntu@<your-instance-ip>
Step 2: Make Installer Executable
chmod +x roostgpt-installer.sh
Step 3: Run the Installer
sudo ./roostgpt-installer.sh
You'll see a professional installation interface:
╔════════════════════════════════════════════════════════════╗
║ ║
║ RoostGPT Installer ║
║ ║
╚════════════════════════════════════════════════════════════╝
[→] Checking system requirements...
[✓] System requirements met
Continue with installation? [Y/n]
Press Y and Enter to continue.
The installer will:
- Extract files
- Install RoostGPT binary
- Set up the parser
- Copy workspace with pre-canned examples
- Configure all necessary permissions
Installation typically completes in under 1 minute.
Step 4: Verify Installation
After successful installation, you'll see:
╔════════════════════════════════════════════════════════════╗
║ ║
║ ✓ RoostGPT Installation Completed Successfully! ║
║ ║
╚════════════════════════════════════════════════════════════╝
Now you can run: roostgpt
Using RoostGPT
Running RoostGPT
You can now run RoostGPT from anywhere on your system:
roostgpt
Workspace Location
Your workspace with pre-canned examples is located at:
~/workspace
cd ~/workspace
Workspace Structure
The workspace contains example projects to help you get started:
~/workspace/
├── Folder1/
│ └── .env # Configuration for project 1
└── Folder2/
└── .env # Configuration for project 2
Running RoostGPT on Workspace Examples
# Navigate to workspace
cd ~/workspace
# Run RoostGPT directly on your projects
roostgpt
# Or specify a specific folder
cd ~/workspace/Folder1
roostgpt
Quick Start Example
# 1. SSH into your Ubuntu instance
ssh ubuntu@<your-instance-ip>
# 2. Navigate to workspace
cd ~/workspace
# 3. Run RoostGPT
roostgpt
# 4. Explore the pre-canned examples
ls -la
Here's a complete workflow from login to running RoostGPT:
Configuration
Each project folder in your workspace contains a .env file for configuration:
# Edit Folder1 configuration
nano ~/workspace/Folder1/.env
# Edit Folder2 configuration
nano ~/workspace/Folder2/.env
Sample Configuration
# Project Configuration
PROJECT_NAME=MyProject
API_KEY=your_api_key_here
DATABASE_URL=postgresql://localhost:5432/mydb
LOG_LEVEL=info
DEBUG=false
Important: Update the .env files with your actual configuration values before running RoostGPT on your projects.
Troubleshooting
Installation Issues
Problem: Permission denied when running installer
# Solution: Make sure you're using sudo
sudo ./roostgpt-installer.sh
Problem: Command not found: roostgpt
# Solution: Verify installation completed successfully
which roostgpt
# Should output: /usr/local/bin/roostgpt
# If not found, re-run the installer
sudo ./roostgpt-installer.sh
Problem: Insufficient disk space
# Solution: Check available space
df -h /
# Free up space or use an instance with more storage
Runtime Issues
Problem: Can't find workspace
# Solution: Workspace is in your home directory
cd ~/workspace
ls -la
Problem: Configuration not loading
# Solution: Ensure .env files exist and are readable
ls -la ~/workspace/*/. env
chmod 644 ~/workspace/*/.env