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
The webinoly command is used to manage Webinoly itself and server-wide settings.
Syntax:
webinoly <option> <argument>
Update & Maintenance
-update
Update Webinoly to the latest version.
Example:
What gets updated:
- Webinoly core scripts
- Library files
- Templates
- Configuration files
- Bug fixes and security patches
-server-reset
Reset server configuration to defaults.
Reset all:
Reset specific component:
webinoly -server-reset=nginx
webinoly -server-reset=php
webinoly -server-reset=mysql
webinoly -server-reset=os
webinoly -server-reset=permissions
webinoly -server-reset=confile
Available reset options:
all - Reset everything (default)
nginx - Reset Nginx configuration
php - Reset PHP-FPM configuration
mysql - Reset MySQL/MariaDB configuration
os - Reset OS settings (timezone, etc.)
permissions - Reset file permissions
confile - Reset Webinoly configuration file
-verify
Verify Webinoly installation integrity.
Example:
Critical verification only:
webinoly -verify=critical
Checks:
- File integrity
- Configuration validity
- Service status
- Required packages
- Permissions
-uninstall
Uninstall Webinoly completely.
Example:
What gets removed:
- Webinoly scripts and files
- Configuration file
- Cron jobs
- Command aliases
- Does NOT remove stack components (use
stack -purge-server-all first)
-info
Display comprehensive system information.
Example:
Shows:
- Server information (OS, kernel, uptime)
- Webinoly version
- Stack versions (Nginx, PHP, MySQL)
- Service status
- Resource usage (CPU, RAM, disk)
- Site count
- Database count
- Configuration settings
-version / -v / -V
Display Webinoly and stack versions.
Example:
Output includes:
- Webinoly version
- Current stack version
- Available stack version (if update available)
Database Management
-dbpass
Display MySQL/MariaDB credentials.
Example:
Shows:
- Root password
- Admin user credentials
- External database credentials (if configured)
-mysql-password
Change MySQL/MariaDB root and admin passwords.
Example:
Interactive mode:
- Prompts for new root password
- Prompts for new admin password
- Updates stored credentials
-mysql-public-access
Manage MySQL remote access.
Enable public access:
webinoly -mysql-public-access=on
Disable public access:
webinoly -mysql-public-access=off
With specific bind address:
webinoly -mysql-public-access=on -bind=192.168.1.100
Security note: Only enable when necessary and use firewall rules to restrict access.
-db-import
Import database from SQL file.
Example:
webinoly -db-import -dbname=mydb -file=/path/to/dump.sql
With overwrite:
webinoly -db-import -dbname=mydb -file=/path/to/dump.sql -overwrite
Skip database creation:
webinoly -db-import -dbname=existing_db -file=/path/to/dump.sql -skip-db
Server Configuration
Change admin tools port.
Example:
webinoly -tools-port=12345
Default port: 22222
Note: Updates:
- Nginx configuration
- Firewall rules (if UFW is enabled)
Configure admin tools domain.
Set custom domain:
webinoly -tools-site=tools.example.com
Disable custom domain:
Default: Access via server IP:port
-default-site
Set default Nginx response for unmatched domains.
Set default site:
webinoly -default-site=example.com
Disable (show default Nginx page):
webinoly -default-site=off
Return 444 (connection closed):
webinoly -default-site=blackhole
-sftp
Manage SFTP access for www-data user.
Enable SFTP access:
Disable SFTP access:
When enabled:
- Creates shell for www-data user
- Allows SFTP login as www-data
- Useful for web-based file managers
- Use with caution (security implications)
-timezone
Set server timezone.
Example:
webinoly -timezone=America/New_York
Interactive mode:
Updates:
- System timezone
- PHP timezone
- MySQL timezone
Valid timezones: https://www.php.net/manual/en/timezones.php
Cache Management
-cache-valid
Set global FastCGI cache validity time.
Example:
webinoly -cache-valid=30d
Time formats:
m - minutes
h - hours
d - days
w - weeks
M - months
y - years
Examples:
webinoly -cache-valid=12h
webinoly -cache-valid=7d
webinoly -cache-valid=1M
-clear-cache
Clear various caches.
Clear all caches:
Clear specific cache:
webinoly -clear-cache=fastcgi
webinoly -clear-cache=opcache
webinoly -clear-cache=redis
webinoly -clear-cache=memcached
Clear site-specific FastCGI cache:
webinoly -clear-cache=example.com
With subfolder:
webinoly -clear-cache=example.com -subfolder=/blog
Available cache types:
fastcgi - FastCGI cache for all sites
opcache - PHP OPcache
redis - Redis cache
memcache / memcached - Memcached
{domain} - Site-specific FastCGI cache
all - All caches
Global Cache Configuration
Skip specific URLs globally:
webinoly -skip-cache=/cart,/checkout,/my-account
Skip specific cookies globally:
webinoly -skip-cookie-cache=comment_author,wordpress_logged_in
Cache specific query strings:
webinoly -query-string-cache=utm_source,utm_medium,utm_campaign
Never cache specific query strings:
webinoly -query-string-never-cache=nocache,preview,debug
Note: These settings apply globally to all sites unless overridden at site level.
Security
-blockip
Block or unblock IP addresses.
Block IP:
webinoly -blockip=192.168.1.100
Block multiple IPs:
webinoly -blockip=192.168.1.100,192.168.1.101,192.168.1.102
Block IP range (CIDR):
webinoly -blockip=192.168.1.0/24
Unblock IP:
webinoly -blockip=192.168.1.100 -delete
List blocked IPs:
Delete all blocked IPs:
webinoly -blockip -delete-all
Manage custom HTTP headers.
Add custom header:
webinoly -custom-headers="X-Custom-Header: value"
Add multiple headers:
webinoly -custom-headers="X-Header-1: value1,X-Header-2: value2"
Remove custom headers:
webinoly -custom-headers -delete
List custom headers:
webinoly -custom-headers -list
Email Configuration
-email
Set email address for notifications.
Example:
webinoly -email=admin@example.com
Used for:
- SSL certificate notifications
- Cron job outputs
- System notifications
-smtp
Configure SMTP relay for outgoing mail.
Setup SMTP:
Interactive setup prompts for:
- SMTP server address
- SMTP port
- SMTP username
- SMTP password
- SMTP encryption (TLS/STARTTLS)
Remove SMTP configuration:
Requirements:
- Postfix must be installed (
stack -postfix)
Backup & Restore
-backup
Manage backups.
Backup wizard:
Local database backup:
webinoly -backup=local -dbname=database_name
Export server configuration:
webinoly -backup=local -export
Export specific site:
webinoly -backup=local -export=example.com
Import server configuration:
webinoly -backup=local -import -source=/path/to/backup.tar
Import types:
webinoly -backup=local -import=stack # Stack config only
webinoly -backup=local -import=full # Complete restore
S3 backup profile:
Run S3 backup:
webinoly -backup=s3 -run=profile-name
List S3 backups:
webinoly -backup=s3 -list=profile-name
Restore from S3:
webinoly -backup=s3 -restore=profile-name -date=2024-01-15
Send file to S3:
webinoly -send-to-s3 -source=/path/to/file -destination=s3-path
-aws-s3-credentials
Configure AWS S3 credentials.
Example:
webinoly -aws-s3-credentials
Interactive prompts for:
- AWS Access Key ID
- AWS Secret Access Key
- Default region
Credentials stored at: ~/.aws/credentials
Advanced Options
-dynvar
Set custom dynamic variables in Webinoly config.
Set variable:
webinoly -dynvar=my-custom-var -value="custom value"
Interactive mode:
webinoly -dynvar=my-custom-var
Use cases:
- Store custom configuration values
- Script automation
- Environment-specific settings
-external-sources-update
Update external data sources.
Example:
webinoly -external-sources-update
Updates:
- Timezone database
- Country codes
- External lists
- Reference data
Backup Arguments
-profile
Backup profile name.
Example:
webinoly -backup=s3 -run=myprofile
-list
List backups or configurations.
Example:
webinoly -backup=s3 -list=profile-name
webinoly -blockip -list
-bucket
S3 bucket name.
Example:
webinoly -backup=s3 -bucket=my-backup-bucket
-source
Source file or directory for operations.
Example:
webinoly -backup=local -import -source=/path/to/backup.tar
webinoly -send-to-s3 -source=/path/to/file
-destination
Destination path for operations.
Example:
webinoly -send-to-s3 -source=/local/file -destination=remote/path
-delete
Delete configuration or entry.
Example:
webinoly -blockip=192.168.1.100 -delete
webinoly -custom-headers -delete
-delete-all
Delete all entries.
Example:
webinoly -blockip -delete-all
-run
Execute backup profile.
Example:
webinoly -backup=s3 -run=daily-backup
-restore
Restore from backup.
Example:
webinoly -backup=s3 -restore=profile-name -date=2024-01-15
-date
Specify backup date for restore.
Example:
webinoly -backup=s3 -restore=profile-name -date=2024-01-15
-wp
WordPress-specific backup operations.
Example:
webinoly -backup=local -export=example.com -wp
-s3-european-buckets
Use European S3 bucket naming.
Example:
webinoly -backup=s3 -bucket=my-bucket -s3-european-buckets
-file
Specify file path.
Example:
webinoly -db-import -dbname=mydb -file=/path/to/dump.sql
-add-db-pre
Add database prefix during backup operations.
Example:
webinoly -backup=local -export=example.com -add-db-pre
-no-recovery
Skip recovery file creation during import.
Example:
webinoly -backup=local -import -source=/path/to/backup.tar -no-recovery
-recalculate
Recalculate during restore operations.
Example:
webinoly -backup=s3 -restore=profile-name -recalculate
-dbname
Specify database name.
Example:
webinoly -db-import -dbname=mydb -file=/path/to/dump.sql
webinoly -backup=local -dbname=wordpress_db
-skip-db
Skip database creation during import.
Example:
webinoly -db-import -dbname=existing_db -file=/path/to/dump.sql -skip-db
-filename
Specify filename for operations.
Example:
webinoly -backup=local -filename=custom-backup-name
-overwrite
Overwrite existing files/databases.
Example:
webinoly -db-import -dbname=mydb -file=/path/to/dump.sql -overwrite
-value
Value for dynamic variables.
Example:
webinoly -dynvar=my-var -value="my value"
-bind
Bind address for MySQL public access.
Example:
webinoly -mysql-public-access=on -bind=192.168.1.100
Common Usage Examples
Initial Server Setup
webinoly -timezone=America/New_York
webinoly -email=admin@example.com
stack -lemp
stack -postfix
webinoly -smtp
Setup S3 backups
stack -backups
webinoly -aws-s3-credentials
webinoly -backup=s3
Enable remote MySQL access
webinoly -mysql-public-access=on
# Configure firewall to allow port 3306
Block malicious IPs
webinoly -blockip=1.2.3.4,5.6.7.8
Clear all caches
webinoly -clear-cache=all
Export server configuration
webinoly -backup=local -export
Import server configuration
webinoly -backup=local -import=full -source=/path/to/backup.tar
Change admin tools to custom domain
webinoly -tools-site=admin.example.com
site admin.example.com -ssl=on
Update Webinoly
Verify installation
Server maintenance
webinoly -server-reset=nginx
webinoly -server-reset=php