Webinoly Settings

The command “Webinoly” allows us to make some changes in the configuration, as well as to consult some aspects of the web server. We will explain in detail the use of this command.

Syntax:

sudo webinoly <option>

Options:

• -backup
• –blockip
• -clear-cache
• -conf-value_
• -config-cache
• –dbpass
• -default-site
• -external-sources-update
• -info
• -login-www-data
• –mysql-password
• -timezone
• -tools-port
• -tools-site
• -server-reset
• –smtp
• -uninstall
• -update
• -verify
• -version
• –yoast-sitemap

Examples:

sudo webinoly -update
sudo webinoly -login-www-data=on
sudo webinoly -clear-cache=all
sudo webinoly -backup=s3 -profile=mysite -run

How do I upgrade to the latest version of Webinoly?

It is very simple, you just have to execute the following command and it will download and install the most recent version of this application.

sudo webinoly -update

It is important to note that this command only updates the Webinoly app, not the other packages installed in the server. You should run a server update and upgrade sudo apt update && sudo apt -y upgrade at least once a month.

Recover MySQL username and password

Webinoly saves a copy of users and passwords generated automatically during the installation of MySQL since these data are necessary to execute some commands, like the creation of the database for WordPress sites, among others.

sudo webinoly -dbpass

The “raw” option is also supported to remove format: sudo webinoly -dbpass -raw.

Change MySQL password

We can only modify the password of the “root” and “admin” users, they are the only ones that Webinoly saves and uses to work.

sudo webinoly -mysql-password

We can also use it in the following way: sudo webinoly -mysql-password=[user,pass].

Access to PhpMyAdmin and other tools

At any time you can modify the access port (0-65535), by default we use port 22222 or the one you chose during the initial installation.

sudo webinoly -tools-port

In the same way, you can automate the execution of the command as follows:

sudo webinoly -tools-port=19816

It is also possible to define an existing domain for “only access” to these tools.

sudo webinoly -tools-site=domain.com

Any request from another domain will be blocked.

Now you can access your tools using domain.com:19816 from your browser. If you want to reset and remove any domain previously set, use the default option: sudo webinoly -tools-site=default.

Allow SFTP access to www-data user

Very useful for uploading files through SFTP, this user has very limited access permissions and can only be used to log in through SFTP and with access only to the file folders of your websites.

sudo webinoly -login-www-data=on

You can block the access at any time.

sudo webinoly -login-www-data=off

FastCgi Cache settings

Webinoly configures three time values for Cache retention.

• HTTP Code 200: Successful requests.
• HTTP Code 301, 302, 307, 404 and 410: Redirects and pages not found.
• Inactivity time: Remove cached data that has not been accessed in the specified time.

To modify the configuration you only have to execute the following command:

sudo webinoly -config-cache

The time parameters must be entered in the following format:

• s – seconds
• m – minutes
• h – hours
• d – days
• w – weeks
• M – Months
• y – years

The command also allows to automate its execution of the following way:

sudo webinoly -config-cache=[10d,1w,5m]

The first argument is the response for 200 codes, the second the downtime and the third for redirects.

Clear/Purge Cache

Options:

• fastcgi
• redis
• memcached
• opcache
• all

# Example:
sudo webinoly -clear-cache=fastcgi
sudo webinoly -clear-cache=all

Set Timezone

This command will set the timezone in PHP and in Ubuntu operating system.

sudo webinoly -timezone

You can also directly pass the data in the following way: sudo webinoly -timezone=America/Mexico_City. Check the supported timezones.

Block and deny IP address

To restrict access in Nginx to a specific IP or block of addresses.

sudo webinoly -blockip=123.231.12.31

In the same way we can use the -purge option to remove it from the list of blocked addresses.

Or to list all the IP’s that have been blocked:

sudo webinoly -blockip -list

# Tip - RAW option is supported to remove format.
sudo webinoly -blockip -list -raw

# Remove IP from the list
sudo webinoly -blockip -purge
sudo webinoly -blockip=123.231.12.31 -purge

Yoast Sitemap

Webinoly have native support for the sitemap included in the Yoast SEO plugin. If you use another sitemap or it’s causing a conflict with another plugin, you can deactivate this function.

sudo webinoly -yoast-sitemap=off

Enable/disable (on/off) this feature globally, this way when a site is created this feature will be enabled or disabled by default according to this setting. For a specific site or after a site is created, you can activate/deactivate this feature using our “site” command.

Default Website

If you access your server from your browser using the IP of the server you will see the Welcome page of Nginx, which is the answer that is configured by default.

Webinoly allows you to customize the site or answer by default.

sudo webinoly -default-site=<option>

default – Nginx default behavior.

blackhole – Any request that does not correspond to an existing domain in the server will return a 444 code in response or in other words, the server will not respond to those requests.

domain – Define an existing domain or site as default response to any request.

SMTP setting for sending emails

Postfix is always installed with Webinoly for sending emails, for instance, all your WordPress sites notifications, and now you can also configure it to send emails using an external SMTP provider such as Amazon SES, Mandrill, Mailgun, SendGrid or any other provider.

sudo webinoly -smtp

All the server outgoing emails from any of your websites will be sent through this service.

# Test the SMTP service from command line:
echo "Subject: test" | sendmail user@domain.com

# Remove the SMTP configuration and use the Postfix default configuration
sudo webinoly -smtp -purge

# Tip for Unattended Scripts
sudo webinoly webinoly -smtp=[smtp_host,user,password,mainhost]

The “mainhost” refers to the domain that will be used by default to send emails when this data is not provided and it must be an existing domain on the server.

Backups

Webinoly has support for automated backups:

• Backups to S3 (AWS)
• Local WordPress database backup

sudo webinoly -backup

At any moment you can make a database backup of any of your WordPress sites and it will be saved locally in your server storage.

sudo webinoly -backup=local

Support only for localhost databases.

# To skip questions
sudo webinoly -backup=local -wp=example.com -destination=/folder

Backups to AWS S3

Incremental backups of any folder and send it to S3.

Create as many profile backups as you need.

sudo webinoly -backup=s3

Before you can make a backup, you need to have your IAM Credential with full access to S3 service.

sudo webinoly -aws-s3-credentials

# To skip questions (unattended)
sudo webinoly -aws-s3-credentials=[aws_access_key_id,aws_secret_access_key]

sudo webinoly -backup=s3 -profile=name -bucket=https://s3.amazonaws.com/bucket/folder -source=/folder -max-age=2M

AWS S3 bucket should be entered in “path-style” URL format, “virtual-hosted” URL is still not supported.

# Path-style URL (Supported)
https://s3-<region>.amazonaws.com/bucket/folder
https://s3.amazonaws.com/bucket/folder

# Virtual-hosted URL (NOT-Supported)
https://bucket.s3-<region>.amazonaws.com/folder
https://bucket.s3.amazonaws.com/folder

The -max-age argument is optional and is the time frame for old backups to keep, the default value is 1M and format is (s, m, h, D, W, M, Y).

To run a new backup:

sudo webinoly -backup=s3 -profile -run

Delete an existing profile:

sudo webinoly -backup=s3 -profile -delete

List profiles:

sudo webinoly -backup -list

Restore or recover the most recent backup:

sudo webinoly -backup=s3 -profile -restore=/folder

You can always use -profile=name to skip questions and -list -raw is supported to remove format characters.

Update, modify or reset server settings

This is an advanced function and you only have to make this type of modifications if you know the impact and result that could cause in the behavior of your server, otherwise we recommend to keep the configuration set by default.

The Webinoly configuration file is located in /opt/webinoly/webinoly.conf and only the following variables can be updated manually, you must be careful not to modify any other values.

• max-mb-uploads
• php-max-mem
• redis-max-mem
• fd-ratio
• nginx-fd-ratio
• swap-mem
• nginx-ppa
• log-lines
• debug
• mail

To modify a variable in the configuration file you can use the command -conf-value_<variable>=<value> as follows: sudo webinoly -conf-value_mail=user@mail.com.

After any modification to the config file, you should do a -server-reset to changes take effect, this command can update the configuration of a specific package (nginx, php, all) in the following way: sudo webinoly -server-reset=php. If the packages (stack) have not been installed yet, the values will be loaded automatically when you do the installation, if they are already installed, the current configuration will be updated and any changes made manually by the user will be lost.

Configuration File

max-mb-uploads – Defines the maximum size of an uploaded file, by default a value of 50MB is declared.

php-max-mem – It establishes the memory limit that a PHP script can use, it is a direct adjustment to the memory_limit variable in the php.ini file.

redis-max-mem – It establishes the memory limit that Redis can use and is a percentaje of the total RAM available, default value is 10.

swap-mem – Webinoly automatically creates a SWAP memory partition, the size is determined based on the amount of RAM installed on your server.

fd-ratio – Linux automatically configures the “file descriptors” limit based on system RAM. More or less it is based on 10% of the RAM taking 1kb for each file to calculate that value. This variable in the configuration file modifies the percentage of RAM taken to perform this calculation.

nginx-fd-ratio – From the total of file descriptors calculated in the previous variable, the percentage assigned or allowed to be used or available for Nginx is calculated. That is, this variable is a percentage of the previous total.

nginx-ppa – We can choose the option “mainline” or “stable”. This option only works before Nginx is installed.

log-lines – It establishes the number of lines that the output of the log command will have, the default value is 10.

# Numeric value in Megabytes
max-mb-uploads:100
php-max-mem:256

# Numeric value in Gigabytes
swap-mem:2

# Numeric value in % percentage
fd-ratio:50
nginx-fd-ratio:80

nginx-ppa:mainline
log-lines:20
debug:true
mail:hello@example.com

In the same way you can add the variable mail:user@domain.com in the configuration file to avoid being asked the first time you create an SSL certificate. Or use debug:true to create SSL certificates in testing environments (Let’s Encrypt Staging Enviroment).

Integrity test

At any time you can verify the integrity of the files related to Webinoly and your web server.

sudo webinoly -verify

This will run a scan for all the main files and check some basic aspects of your configuration.

System information

To see all the information regarding the installation, configuration and optimization made by Webinoly on your server.

sudo webinoly -info

Normally we use it to debug and detect any errors if necessary.

You can also check the Webinoly version: sudo webinoly -version (-v, -V).

Uninstall Webinoly

Although we regret that you make this decision, the following command will completely remove Webinoly and all its files from the server.

sudo webinoly -uninstall

Notes:

• This action will not delete your websites, their files and data.
• The configuration of your server, as well as the installed packages will not be affected or uninstalled.
• The Webinoly commands to create and manage your server and websites will be removed and will no longer be available for use.

For a complete removing Webinoly guide, check our FAQ section.

If you have any suggestions, ideas, or comments, or if you (gasp!) found a bug, join us in the support forum.