En

Requirements for Sherpa Orchestrator Server (Local Installation)#

System Requirements#

  • OS: Debian 11 minimal (recommended), other Linux distributions with possible modifications
  • CPU: x86_64, minimum 2 cores
  • RAM: 4 GB minimum, 8 GB+ recommended
  • Disk: 20 GB+ of free space
  • Network: Fixed IP address and stable internet connection for all expected clients
  • Access: sudo rights for installation

Important:

  • Installation takes time due to downloading packages and dependencies
  • After installation, internet is not required for operation
  • The server must have a fixed IP address

Preparing the Server#

Checking System Resources#

# Check system resources
df -h          # Disk space
free -h        # RAM
lscpu | grep -E "^CPU\(s\)|Model name"  # CPU information
💡 Comments on Resource Check

df -h - shows disk space usage in human-readable format free -h - shows information about RAM lscpu - shows information about the CPU

Recommended minimum values:

  • Disk: at least 20 GB of free space
  • RAM: at least 4 GB
  • CPU: at least 2 cores

Checking Port Availability#

Sherpa Orchestrator uses the following ports:

  • 443 - HTTPS web interface (mandatory)
  • 3306 - MySQL/MariaDB database
  • 5432 - PostgreSQL database (optional)

Checking Port Availability#

# Check if the required ports are occupied
sudo netstat -tlnp | grep -E ":443 |:3306 |:5432 " || echo "Ports are free"
💡 Comments on Port Check

sudo netstat -tlnp - shows all listening TCP ports and processes

  • -t - TCP ports
  • -l - only listening ports
  • -n - numeric format (without name resolution)
  • -p - shows PID and process name

Expected Result:

  • If the ports are free, the command will output "Ports are free"
  • If the ports are occupied, it will show the processes using them

Supported Operating Systems#

  • Debian 11 (recommended for this guide)
  • Ubuntu 18.04+
  • CentOS 7/8
  • Other Linux distributions (with possible command modifications)

Network Requirements#

  • Fixed IP address - critically important for client access
  • Internet access - for downloading packages and updates
  • DNS resolution - for accessing package repositories

Security Requirements#

  • SSL/TLS certificates - for HTTPS access
  • Firewall - must allow access to port 443
  • SELinux/AppArmor - must be configured or disabled if issues arise

Final Check Before Installation#

# Check system resources
echo "=== System Resources ==="
df -h /
free -h
lscpu | grep -E "^CPU\(s\)|Model name"

# Check network
echo "=== Network Configuration ==="
ip addr show

# Check access to repositories
echo "=== Access to Repositories ==="
sudo apt update --dry-run 2>/dev/null | head -10

echo "If all checks are successful, you can proceed with the installation of Sherpa Orchestrator"