Getting runcloud right from the start saves hours of debugging later. In this comprehensive guide, we'll cover everything from initial setup to production-ready configuration, including php and management considerations.
Prerequisites
- A fresh VPS with a supported OS
- Basic familiarity with the Linux command line
- A VPS running Ubuntu 22.04 or later (2GB+ RAM recommended)
Installation Process
Performance benchmarks show that properly tuned runcloud can handle significantly more concurrent connections than the default configuration. The key improvements come from adjusting worker processes and connection pooling.
# Install the control panel
sudo apt update && sudo apt upgrade -y
curl -fsSL https://get.runcloud.org | bash
# Access the panel
echo "Panel URL: https://$(hostname -I | awk '{print $1}'):8443"
echo "Default credentials: admin / check installation output"
The configuration above sets the recommended values for a VPS with 2-4GB of RAM. Adjust the memory-related settings proportionally if your server has different specifications.
- Use SSH keys instead of password authentication
- Enable firewall and allow only necessary ports
- Set up fail2ban for brute force protection
- Use strong, unique passwords for all services
- Keep all software components up to date
Initial Configuration
Security should be a primary consideration when configuring runcloud. Always use strong passwords, keep software updated, and restrict network access to only the necessary ports and IP addresses.
# Common panel management commands
sudo runcloud list
sudo runcloud restart
sudo runcloud v-change-web-domain-backend-tpl admin example.com PHP-8.2
sudo runcloud status
This configuration provides a good balance between performance and resource usage. For high-traffic scenarios, you may need to increase the limits further.
Managing Websites and Domains
Before making changes to the configuration, always create a backup of the existing files. This ensures you can quickly roll back if something goes wrong during the setup process.
# Install the control panel
sudo apt update && sudo apt upgrade -y
curl -fsSL https://get.runcloud.org | bash
# Access the panel
echo "Panel URL: https://$(hostname -I | awk '{print $1}'):8443"
echo "Default credentials: admin / check installation output"
Make sure to restart the service after applying these changes. Some settings require a full restart rather than a reload to take effect.
- Use version control for configuration files
- Maintain runbooks for common operations
- Document all configuration changes
- Set up monitoring before going to production
- Test disaster recovery procedures regularly
Security Configuration
Regular maintenance is essential for keeping your runcloud installation running smoothly. Schedule periodic reviews of log files, disk usage, and security updates to prevent issues before they occur.
# Common panel management commands
sudo runcloud list
sudo runcloud restart
sudo runcloud v-change-web-domain-backend-tpl admin example.com PHP-8.2
sudo runcloud status
The output should show the service running without errors. If you see any warning messages, address them before proceeding to the next step.
Advanced Settings
If you encounter issues during setup, check the system logs first. Most problems can be diagnosed by examining the output of journalctl or the application-specific log files in /var/log/.
- Keep your system packages updated regularly
- Monitor disk space usage and set up alerts
- Enable automatic security updates for critical patches
- Review log files weekly for anomalies
- Test your backup restore procedure monthly
Common Issues and Solutions
- Slow performance: Check for disk I/O bottlenecks with
iostat -x 1and network issues withmtr. Review application logs for slow queries or requests. - High memory usage: Review the configuration for memory-related settings. Reduce worker counts or buffer sizes if running on a low-RAM VPS.
- Connection timeout: Verify your firewall rules allow traffic on the required ports. Use
ss -tlnpto confirm the service is listening on the expected port.
Summary
You've successfully configured runcloud on your VPS. Remember to monitor performance, keep your software updated, and maintain regular backups. If you run into issues, consult the official documentation or open a support ticket for assistance.