webinoly Command

Main Webinoly server management command for updates, configuration, and system-wide settings

Overview

The webinoly command is the primary tool for managing your Webinoly installation, server configuration, backups, and global settings.

Basic Usage

sudo webinoly <option> <argument>

System Management

Update Webinoly

Update Webinoly to the latest version:

sudo webinoly -update

This updates Webinoly itself, not the server stack components.

Server Reset

Reset server configuration to defaults:

sudo webinoly -server-reset

Reset specific components:

-server-reset · string · default: "all"

Component to reset:

• all - Reset all configurations (default)
• os - Operating system settings
• nginx - Nginx configuration
• php - PHP configuration
• mysql - MySQL/MariaDB configuration
• permissions - File permissions
• confile - Configuration file

sudo webinoly -server-reset=nginx
sudo webinoly -server-reset=php

Verify Installation

Verify Webinoly installation integrity:

sudo webinoly -verify

Critical verification (checks essential components only):

sudo webinoly -verify=critical

Uninstall

Remove Webinoly from your server:

sudo webinoly -uninstall

This removes Webinoly management tools but keeps your server stack installed. To remove the entire stack, use sudo stack -purge-server-all instead.

Version Information

Display version information:

sudo webinoly -version

Alternatives: -v, -V

Example output:

Webinoly version: 1.20.0

Database Management

Display Database Password

Show MySQL/MariaDB root credentials:

sudo webinoly -dbpass

This displays the root database password stored during installation.

Change MySQL Password

Change the MySQL/MariaDB root password:

sudo webinoly -mysql-password

You’ll be prompted to enter a new password.

MySQL Public Access

Enable or disable remote MySQL access:

# Enable public access (bind to 0.0.0.0)
sudo webinoly -mysql-public-access=on

# Disable public access (bind to localhost)
sudo webinoly -mysql-public-access=off

# Bind to specific IP
sudo webinoly -mysql-public-access=192.168.1.100

-bind · string

Specific IP address to bind MySQL to (optional)

Enabling public MySQL access can be a security risk. Ensure you have proper firewall rules and strong passwords.

Tools and Services

Tools Port

Change the port for the Webinoly tools site:

sudo webinoly -tools-port=22222

Default port is 22222.

Tools Site

Configure the tools site domain:

sudo webinoly -tools-site=tools.example.com

This allows you to access phpMyAdmin and other tools via a domain instead of IP:port.

SFTP Access

Manage SFTP access for the www-data user:

# Enable SFTP access
sudo webinoly -sftp=on

# Disable SFTP access
sudo webinoly -sftp=off

When enabled, you can log in via SFTP as the www-data user to manage website files.

Default Site Response

Configure the default Nginx response for requests to your server IP:

# Show default site
sudo webinoly -default-site=default

# Return 444 (close connection)
sudo webinoly -default-site=444

# Redirect to a domain
sudo webinoly -default-site=example.com

Cache Management

Clear Cache

Clear various cache types:

# Clear all caches
sudo webinoly -clear-cache

# Clear specific cache types
sudo webinoly -clear-cache=redis
sudo webinoly -clear-cache=memcache
sudo webinoly -clear-cache=opcache
sudo webinoly -clear-cache=fastcgi

# Clear cache for specific site
sudo webinoly -clear-cache=example.com

-clear-cache · string · default: "all"

Cache type to clear:

• all - All cache types (default)
• redis - Redis object cache
• memcache / memcached - Memcached cache
• opcache - PHP OPcache
• fastcgi - FastCGI page cache
• [domain] - FastCGI cache for specific site

Supports subfolder option:

sudo webinoly -clear-cache=example.com -subfolder=/blog

Cache Valid Time

Configure FastCGI cache valid time:

sudo webinoly -cache-valid=7d

Format: 1h, 30m, 7d, etc.

Security

Block IP Addresses

Block IP addresses at the Nginx level:

# Block an IP
sudo webinoly -blockip=192.168.1.100

# Block multiple IPs
sudo webinoly -blockip=192.168.1.100,192.168.1.101

# Unblock an IP
sudo webinoly -blockip=192.168.1.100 -delete

# List blocked IPs
sudo webinoly -blockip -list

Email Configuration

Update Email

Set your email address for notifications:

sudo webinoly -email=[e-mail]

This email is used for Let’s Encrypt notifications and system alerts.

SMTP Configuration

Configure SMTP for sending emails:

# Configure SMTP (interactive)
sudo webinoly -smtp

# Remove SMTP configuration
sudo webinoly -smtp -purge

You’ll be prompted for SMTP server details, username, and password.

Backup and Restore

Local Backups

Create and manage local backups:

# Export full server configuration
sudo webinoly -backup=local -export

# Export specific site
sudo webinoly -backup=local -export=example.com

# Import server configuration
sudo webinoly -backup=local -import -source=/path/to/backup.tar

-export · string

Export type:

• true / stack - Server stack configuration
• full - Complete server backup
• [domain] - Specific site backup

-import · string

Import backup:

• true / stack - Import server configuration
• full - Import full backup

-source · string

Path to backup file for import

Database Backups

Create local database backups:

# Backup all databases
sudo webinoly -backup=local

# Backup with custom filename
sudo webinoly -backup=local -filename=my-backup.sql

AWS S3 Backups

Configure and manage S3 backups:

# Configure S3 credentials
sudo webinoly -aws-s3-credentials

# Create backup profile
sudo webinoly -backup=s3 -profile=daily

# List backup profiles
sudo webinoly -backup=s3 -list

# Run backup
sudo webinoly -backup=s3 -run=daily

# Restore from S3
sudo webinoly -backup=s3 -restore -profile=daily

# Send file to S3
sudo webinoly -send-to-s3=/path/to/file -bucket=my-bucket

-profile · string

Backup profile name

-bucket · string

S3 bucket name

-run · string

Run backup with specified profile

-restore · boolean

Restore from S3 backup

-date · string

Specific backup date to restore

-s3-european-buckets · boolean

Use European S3 bucket configuration

Database Import

Import SQL database dump:

# Import to new database
sudo webinoly -db-import=/path/to/dump.sql -dbname=newdb

# Import with options
sudo webinoly -db-import=/path/to/dump.sql -dbname=newdb -overwrite

-dbname · string

Target database name

-overwrite · boolean

Overwrite existing database

System Configuration

Timezone

Set server timezone:

# Interactive (prompts for timezone)
sudo webinoly -timezone

# Direct
sudo webinoly -timezone=America/New_York

See PHP timezone list for valid values.

Dynamic Variables

Store custom configuration variables:

# Set a variable
sudo webinoly -dynvar=my-variable -value="my value"

# Variable is stored in /opt/webinoly/webinoly.conf

-dynvar · string

Variable name (alphanumeric and hyphens only)

-value · string

Variable value

Cache Customization

Global Cache Rules

Configure global FastCGI cache behavior:

# Skip cache for specific URLs
sudo webinoly -skip-cache=/checkout,/cart

# Skip cache based on cookies
sudo webinoly -skip-cookie-cache=wordpress_logged_in,comment_author

# Cache specific query strings
sudo webinoly -query-string-cache=page,product_id

# Never cache specific query strings
sudo webinoly -query-string-never-cache=nocache,preview

-skip-cache · string

Comma-separated list of URL paths to skip caching

-skip-cookie-cache · string

Comma-separated list of cookies that bypass cache

-query-string-cache · string

Query strings to include in cache key

-query-string-never-cache · string

Query strings that always bypass cache

HTTP Headers

Manage custom HTTP headers:

# Add custom header (interactive)
sudo webinoly -custom-headers

# You'll be prompted for header name and value

System Information

Display comprehensive system information:

sudo webinoly -info

Shows:

• Webinoly version
• Server stack versions (Nginx, PHP, MySQL/MariaDB)
• Installed components
• Server resources (CPU, RAM, disk)
• Configuration settings

Update External Sources

Update external data sources (like IP blocklists):

sudo webinoly -external-sources-update

Examples

Complete Server Setup

# Update Webinoly
sudo webinoly -update

# Verify installation
sudo webinoly -verify

# Set timezone
sudo webinoly -timezone=America/New_York

# Set notification email
sudo webinoly -email=[e-mail]

# Configure tools site
sudo webinoly -tools-site=admin.example.com

Security Hardening

# Block malicious IPs
sudo webinoly -blockip=192.168.1.100,192.168.1.101

# Configure default site response
sudo webinoly -default-site=444

# Disable MySQL public access
sudo webinoly -mysql-public-access=off

Backup Strategy

# Configure S3 credentials
sudo webinoly -aws-s3-credentials

# Create daily backup profile
sudo webinoly -backup=s3 -profile=daily

# Run backup
sudo webinoly -backup=s3 -run=daily

# Also create local backup
sudo webinoly -backup=local -export=full

Cache Management

# Configure cache valid time
sudo webinoly -cache-valid=7d

# Set global skip cache rules
sudo webinoly -skip-cache=/checkout,/cart,/my-account

# Clear all caches
sudo webinoly -clear-cache

Notes

• All commands require sudo (root privileges)
• Most destructive operations will prompt for confirmation unless force is used
• Configuration changes are stored in /opt/webinoly/webinoly.conf
• Nginx is automatically reloaded after configuration changes
• Use -help to see all available options

See Also

• Stack Management - Install and configure server components
• Site Management - Create and manage websites
• Log Management - View and manage logs