Automated installation scripts for deploying Red5 Pro Server on Proxmox Virtual Environment using LXC containers.

This repository provides Proxmox helper scripts that automate the deployment of Red5 Pro Server in LXC containers. Red5 Pro is a real-time streaming server supporting WebRTC, RTMP, RTSP, HLS, and SRT protocols for ultra-low latency streaming applications.

• Automated LXC Container Creation: Pre-configured with optimal resources for Red5 Pro
• Java 21 Installation: Automatically installs required Java runtime
• License Configuration: Interactive prompt for Red5 Pro license key
• Flexible Download Options: Support for custom download URLs
• Optional SSL/TLS: Let's Encrypt certificate integration with automatic renewal
• Systemd Service: Red5 Pro configured as a system service with auto-start
• Firewall Configuration: Automatic UFW rules for all required ports
• Update Support: Built-in update mechanism for future releases

• Proxmox VE 8.x or higher
• Root access to Proxmox host
• Internet connectivity for package downloads

• Valid Red5 Pro license key from https://account.red5.net/
• Red5 Pro server zip file hosted at an accessible URL

• Domain name pointing to your server's IP address
• Ports 80 and 443 accessible from the internet (for Let's Encrypt validation)
• Valid email address for certificate notifications

Run the following command on your Proxmox host with the required parameters:

bash <(wget -qLO - https://raw.githubusercontent.com/red5pro/proxmox/main/ct/red5install.sh) \
  --license "your-license-key" \
  --download-url "https://your-server.com/path/to/red5pro-server.zip"

Required:

• --license KEY - Your Red5 Pro license key (obtain from https://account.red5.net/)
• --download-url URL - Direct URL to download the Red5 Pro server zip file

Optional:

• --ssl-domain DOMAIN - Your domain name (e.g., red5.example.com)
• --ssl-email EMAIL - Email address for Let's Encrypt notifications
• --verbose - Enable verbose output for debugging
• --help - Show help message

Basic Installation (no SSL):

bash <(wget -qLO - https://raw.githubusercontent.com/red5pro/proxmox/main/ct/red5install.sh) \
  --license "your-license-key-here" \
  --download-url "https://your-server.com/path/to/red5pro-server.zip"

Installation with SSL:

bash <(wget -qLO - https://raw.githubusercontent.com/red5pro/proxmox/main/ct/red5install.sh) \
  --license "ABC123-DEF456-GHI789" \
  --download-url "https://files.example.com/red5pro-server-11.0.0.zip" \
  --ssl-domain "red5.example.com" \
  --ssl-email "admin@example.com"

Installation with Verbose Output (for debugging):

bash <(wget -qLO - https://raw.githubusercontent.com/red5pro/proxmox/main/ct/red5install.sh) \
  --license "your-license-key" \
  --download-url "https://your-server.com/path/to/red5pro-server.zip" \
  --verbose

During installation, you can choose:

1. Default Settings - Automated installation with optimal defaults
2. Advanced Settings - Customize CPU, RAM, disk, network, etc.
3. Config File - Use a previously saved configuration

• CPU: 4 cores
• RAM: 4096 MB (4 GB)
• Disk: 4 GB
• OS: Ubuntu 24.04
• Type: Privileged container
• Category: Media

The following ports are configured and opened (if UFW is active):

After successful installation:

Without SSL:

• HTTP: http://<container-ip>:5080

With SSL:

• HTTP: http://<domain>:5080
• HTTPS: https://<domain>
• RTMPS: rtmps://<domain>:8443

Red5 Pro runs as a systemd service:

# Check service status
systemctl status red5pro

# Start service
systemctl start red5pro

# Stop service
systemctl stop red5pro

# Restart service
systemctl restart red5pro

# View logs
journalctl -u red5pro -f

Application logs are located at:

• /usr/local/red5pro/log/red5.log

If SSL is configured during installation:

• Certificates automatically renew every 90 days via certbot
• Post-renewal hook regenerates Java keystores and truststores
• Red5 Pro service automatically restarts after renewal

To manually renew certificates:

certbot renew
/etc/letsencrypt/renewal-hooks/post/red5pro-renew.sh

Certificate files are stored at:

• /etc/letsencrypt/live/<domain>/
  • fullchain.pem - Full certificate chain
  • privkey.pem - Private key
  • keystore.jks - Java keystore
  • truststore.jks - Java truststore

• Main Config: /usr/local/red5pro/conf/red5-core.properties
• Service File: /lib/systemd/system/red5pro.service
• License File: /usr/local/red5pro/LICENSE.KEY

SSL configuration is appended to red5-core.properties:

# HTTPS Configuration
https.port=443
https.keystorepass=changeit
https.keystorefile=/etc/letsencrypt/live/<domain>/keystore.jks
https.truststorepass=changeit
https.truststorefile=/etc/letsencrypt/live/<domain>/truststore.jks

# RTMPS Configuration
rtmps.port=8443
rtmps.keystorepass=changeit
rtmps.keystorefile=/etc/letsencrypt/live/<domain>/keystore.jks
rtmps.truststorepass=changeit
rtmps.truststorefile=/etc/letsencrypt/live/<domain>/truststore.jks

The container script includes an update function. To update Red5 Pro:

# From inside the container
/usr/local/bin/update

Note: The update mechanism requires GitHub releases to be published at red5pro/proxmox with assets matching the pattern red5pro-server-*-release.zip.

Certificate Generation Fails:

• Verify domain DNS points to server IP
• Ensure ports 80 and 443 are accessible
• Check firewall rules on both Proxmox host and router
• Review certbot logs: journalctl -u certbot

Service Won't Start:

• Check Java installation: java -version
• Verify license key: cat /usr/local/red5pro/LICENSE.KEY
• Review service status: systemctl status red5pro
• Check logs: tail -f /usr/local/red5pro/log/red5.log

Download Fails:

• Verify custom URL is accessible
• Check network connectivity from container
• Ensure sufficient disk space

Port Already in Use:

# Check what's using the port
ss -tulpn | grep :5080

Permission Issues:

# Verify Red5 Pro directory ownership
ls -la /usr/local/red5pro

Java Heap Size: Edit /lib/systemd/system/red5pro.service and modify memory settings if needed.

proxmox/
├── ct/
│   └── red5install.sh          # Container creation script
├── install/
│   └── red5-install.sh         # Installation script (runs inside container)
├── frontend/
│   └── public/
│       └── json/
│           └── red5pro.json    # Metadata for helper scripts website
└── README.md                    # This file

This repository follows the Proxmox VE Helper-Scripts standard structure:

• ct/: Container creation scripts
• install/: Application installation scripts
• frontend/public/json/: Metadata files for web interface

When developing or testing modifications:

1. Fork this repository
2. Update script URLs to point to your fork
3. Test in a non-production Proxmox environment
4. Submit pull requests with changes

Contributions are welcome! Please ensure:

• Scripts follow existing coding standards
• Changes are tested on Proxmox VE 8.x+
• Documentation is updated accordingly

• Official Docs: https://www.red5.net/docs/
• SSL Configuration: https://www.red5.net/docs/installation/ssl/lets-encrypt/
• Account Portal: https://account.red5.net/

• Proxmox VE: https://www.proxmox.com/
• Community Scripts: https://community-scripts.github.io/ProxmoxVE/

• Certbot: https://certbot.eff.org/
• Documentation: https://letsencrypt.org/docs/

MIT License - Copyright (c) 2025 mondain

See LICENSE file for details.

Paul Gregoire (mondain)

For issues related to:

• These scripts: Open an issue at https://github.com/red5pro/proxmox/issues
• Red5 Pro Server: Contact Red5 Pro support or visit https://www.red5.net/
• Proxmox VE: Visit https://forum.proxmox.com/

• Default keystore/truststore password is changeit (Red5 Pro standard)
• License keys are stored in plain text at /usr/local/red5pro/LICENSE.KEY
• Ensure proper firewall rules to restrict access to management ports
• Keep Red5 Pro updated with latest security patches
• Use SSL/TLS for production deployments

This is an unofficial helper script for Red5 Pro Server. Red5 Pro is a commercial product requiring a valid license. Always review scripts before execution and test in non-production environments first.