Updating Webinoly

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/QROkes/webinoly/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

Update Webinoly

​

Check for Updates

webinoly -version

• Current Webinoly version
• Installed stack version
• Available stack version (if newer)

​

Standard Update

sudo webinoly -update

1. Webinoly checks for the latest version via API
2. Downloads the new version from official repository
3. Runs migration scripts for version upgrades
4. Updates configuration files
5. Resets server configuration to latest optimized settings
6. Verifies installation integrity

​

Update from Specific Version

# Downgrade to specific version
sudo webinoly -update=1.20.0

# Note: Beta/alpha versions cannot be updated to stable

​

Update from Branch

# Beta branch
sudo webinoly -update=beta

# Alpha branch
sudo webinoly -update=alpha

​

Update Server Stack

sudo stack -update

• NGINX to latest version
• PHP to latest version
• MySQL/MariaDB to latest version
• System packages
• Dependencies

​

What Gets Updated

​

Webinoly Application

• Core Webinoly scripts (/opt/webinoly/)
• Command-line tools (webinoly, site, stack, httpauth, log)
• Configuration templates
• Library functions
• Helper scripts

• Site files and databases
• SSL certificates
• User configurations
• Backup profiles
• Custom site configurations

​

Server Stack Components

• Binary and modules
• Configuration files (regenerated with optimizations)
• Common configuration includes

• PHP-FPM and CLI
• PHP extensions
• Configuration files (regenerated with optimizations)
• Pool configurations

• Server binaries
• Configuration files (optimizations applied)
• No data changes

• Certbot (Let’s Encrypt client)
• Duplicity and Duply (backup tools)
• Redis server
• Memcached
• Postfix
• phpMyAdmin

​

Update Process Details

​

Pre-Update Steps

1. Backup Configuration: Webinoly automatically creates a backup:
   ~/.webinoly-conf-restore_dont-remove
   
2. Version Validation: Checks current and target versions
3. API Check: Verifies latest available version

​

During Update

1. Download: Fetches update script from official repository
2. Migration: Runs version-specific migration scripts:
   • Updates configuration format
   • Migrates deprecated settings
   • Updates system dependencies
   • Regenerates configuration files
3. Service Management: Automatically handles service restarts
4. Verification: Runs integrity checks after update

​

Post-Update

1. Resets server configuration (see below)
2. Verifies installation
3. Shows update completion message

​

Migration Versions

​

Major Version Migrations

• Removes old phpMyAdmin installation
• Installs newer phpMyAdmin version
• Updates Let’s Encrypt integration

• Adds zip utility

• Removes deprecated “ssl on” directive
• Updates swappiness configuration
• Backs up default NGINX file

• Creates apps.d directory
• Updates ACL configuration
• Adds HTTP authentication support

• Updates FastCGI parameters
• Removes debug pool configuration
• Updates admin tools structure

• Switches to official NGINX repository
• Updates package signing keys
• Migrates from PPA to official repo

• Removes Certbot from apt
• Installs Certbot via snap
• Updates SSL renewal configuration

• Migrates header configurations
• Updates site includes
• Renames admin tools folder

• Enables HTTP/3 for SSL sites
• Updates NGINX keys

• Updates boto3 for S3 backups on Ubuntu 24.04

• Updates MariaDB repository configuration

• Regenerates configuration file format

​

Update Verification

# Quick verification
webinoly -verify=critical

# Full verification
webinoly -verify

# Check version
webinoly -version

# View system info
webinoly -info

​

Update Failures

​

If Update Fails

1. Check error message: Read the error output carefully
2. Review logs:
   sudo tail -f /var/log/syslog
   
3. Restore configuration (if needed):
   sudo tar -xf ~/.webinoly-conf-restore_dont-remove -C /
   
4. Re-run update:
   sudo webinoly -update
   
5. Manual recovery:
   # Verify installation
   webinoly -verify
   
   # Reset configuration
   webinoly -server-reset=all
   

​

Common Update Issues

• Check internet connectivity
• Retry after a few minutes
• Use specific version: sudo webinoly -update=1.20.0

• Free up disk space before updating
• Remove old packages: sudo apt clean

• Check snap is installed: snap version
• Manually install: sudo snap install --classic certbot

• Regenerate config: webinoly -server-reset=confile
• Run verification: webinoly -verify

​

Update Schedule

​

Recommended Update Frequency

• Check monthly for updates
• Apply security updates immediately
• Review changelog before major version updates

• Update quarterly or as needed
• Apply security patches promptly
• Test in staging environment first

• Apply security updates weekly
• Check for updates:
  sudo apt update
  sudo apt list --upgradable
  

​

Rollback

​

Emergency Rollback

1. Restore configuration:
   sudo tar -xf ~/.webinoly-conf-restore_dont-remove -C /
   
2. Downgrade packages (if needed):
   # Check available versions
   apt-cache policy nginx
   
   # Install specific version
   sudo apt install nginx=1.24.0-1~jammy
   
3. Verify installation:
   webinoly -verify
   

​

Best Practices

​

Before Updating

1. Backup Everything:
   # Backup sites and databases
   webinoly -backup=local -export
   
   # Backup configuration
   sudo tar -czf ~/webinoly-backup.tar.gz /opt/webinoly /etc/nginx /etc/php
   
2. Note Current Versions:
   webinoly -version
   webinoly -info
   
3. Check Changelog: Review changes in new version
4. Schedule Maintenance Window: Plan for potential downtime
5. Inform Users: Notify about maintenance

​

During Update

1. Monitor Progress: Watch for errors
2. Don’t Interrupt: Let update complete
3. Save Output: Keep terminal output for reference

​

After Update

1. Run Verification:
   webinoly -verify
   
2. Test Sites: Check all sites are working
3. Review Configurations: Check for reset settings
4. Check Logs: Look for errors
   sudo tail -f /var/log/nginx/error.log
   sudo tail -f /var/log/syslog
   
5. Update Documentation: Note any manual changes needed

​

Automatic Updates

​

Why Manual Updates?

• Gives you control over update timing
• Allows review of changes before applying
• Prevents unexpected breaking changes
• Enables proper backup before updates

​

Optional Automation

# Create cron job (use with caution)
echo "0 3 * * 0 root /usr/bin/webinoly -update" | sudo tee -a /etc/crontab

​

Update External Sources

webinoly -external-sources-update

• Public Suffix List (for domain validation)
• Timezone Database (for PHP timezone support)

​

Stay Informed

• GitHub Releases: https://github.com/QROkes/webinoly/releases
• Changelog: Review changes before updating
• Community: Join discussions about updates
• Newsletter: Subscribe for update notifications

​

Next Steps

• Troubleshooting - Fix update issues
• Server Management - Configure updated server
• Verify Installation - Check update success