Professional Documents
Culture Documents
Bitnami WordPress Installer
Bitnami WordPress Installer
Bitnami WordPress Installer
Bitnami Documentation Pages (/) > Windows / Linux / MacOS (/installer/) >
Application Stacks (/installer/apps/) > WordPress (/installer/apps/wordpress/)
NOTE: Before running the commands shown on this page, you should load the Bitnami
stack environment by executing the installdir/use_APPNAME script (Linux and Mac OS
X) or by clicking the shortcut in the Start Menu under "Start -> Bitnami APPNAME
Stack -> Application console" (Windows). Learn more
(/installer/components/bnconsole).
Feedback
NOTE: When running the commands shown on this page, replace the installdir
placeholder with the full installation directory for your Bitnami stack.
Description
Wordpress is the world's most popular blogging and content management platform.
Powerful yet simple, everyone from students to global corporations use it to build beautiful,
functional websites.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 1/64
3/29/2018 Bitnami WordPress Installer
Feedback
Check the FAQ instructions on how to download and install a Bitnami Stack
(/installer/faq#how-to-download-and-install-a-bitnami-stack) for more details.
The application will be installed to the following default directories:
Windows C:\Bitnami\APPNAME-VERSION
Mac OS X /Applications/APPNAME-VERSION
OS X VM
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 2/64
3/29/2018 Bitnami WordPress Installer
Download the OS X VM file for the Bitnami WordPress Stack from the Bitnami
website (https://bitnami.com/stacks).
Begin the installation process by double-clicking the image file and dragging the
WordPress OS X VM icon to the Applications folder.
Launch the VM by double-clicking the icon in the Applications folder.
Feedback
Linux
Bitnami native installers include a graphical tool to manage services. This tool is named
manager-linux-x64.run on Linux and is located in the installation directory. To use this tool,
double-click the file and then use the graphical interface to start, stop or restart services.
Server log messages can be checked in the "Server Events" tab.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 3/64
3/29/2018 Bitnami WordPress Installer
(/images/img/platforms/installer/manager-linux-2a7638cb.png)
The native installer also includes a command-line script to start, stop and restart
applications, named ctlscript.sh. This script can be found in the installation directory and
accepts the options start, stop, restart, and status. To use it, log in to the server console
and execute it following the examples below:
Feedback
Call it without any service names to start all services:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Use it to restart a specific service only by passing the service name as argument - for
example, mysql, postgresql or apache:
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 4/64
3/29/2018 Bitnami WordPress Installer
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
$ installdir/ctlscript.sh status
The list of available services varies depending on the required components for each
application.
Mac OS X
Bitnami native installers include a graphical tool to manage services. This tool is named
manager-osx on Mac OS X and is located in the installation directory. To use this tool,
double-click the file and then use the graphical interface to start, stop or restart services.
Server log messages can be checked in the "Server Events" tab.
Feedback
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 5/64
3/29/2018 Bitnami WordPress Installer
(/images/img/platforms/installer/manager-osx-b9ade46e.png)
The native installer also includes a command-line script to start, stop and restart
applications, named ctlscript.sh. This script can be found in the installation directory and
accepts the options start, stop, restart, and status. To use it, log in to the server console
and execute it following the examples below:
Feedback
Call it without any service names to start all services:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Use it to restart a specific service only by passing the service name as argument - for
example, mysql or apache:
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 6/64
3/29/2018 Bitnami WordPress Installer
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
$ installdir/ctlscript.sh status
The list of available services varies depending on the required components for each
application.
NOTE: If you are using the stack manager for Mac OS X-VM, please check the
following blog post (https://engineering.bitnami.com/articles/redmine-vm-for-mac-tell-
us-what-you-think.html) to learn how to manage services from its graphical tool.
Windows
Bitnami native installers include a graphical tool to manage services. This tool is named
manager-windows.exe on Windows and is located in the installation directory. To use this
tool, double-click the file and then use the graphical interface to start, stop or restart
services. Server log messages can be checked in the "Server Events" tab.
Feedback
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 7/64
3/29/2018 Bitnami WordPress Installer
(/images/img/platforms/installer/manager-windows-c681d38a.png)
The Windows native installer creates shortcuts to start and stop services created in the
Start Menu, under "Programs -> Bitnami APPNAME Stack -> Bitnami Service". Servers
can also be managed from the Windows "Services" control panel. Services are named
using the format APPNAMESERVICENAME, where APPNAME is a placeholder for the
Feedback
application name and SERVICENAME is a placeholder for the service name. For example,
the native installer for the Bitnami WordPress Stack installs services named
wordpressApache and wordpressMySQL.
These services will be automatically started during boot. To modify this behaviour, refer to
the section on disabling services on Windows (/installer/windows-
faq#disable_autostart_windows).
with
define('WP_SITEURL', 'http://DOMAIN/');
define('WP_HOME', 'http://DOMAIN/');
NOTE: Your domain name should be correctly propagated for this to work. You can
verify the new DNS record by using the Global DNS Propagation Checker
(https://www.whatsmydns.net/) and entering your domain name into the search field.
Feedback
Click on the "Settings -> General" tab located in the menu on the left.
Scroll down until "Site Language" and select the one you prefer and click ."Save
Changes".
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 9/64
3/29/2018 Bitnami WordPress Installer
(/images/img/apps/wordpress/wordpress-change-language-6ddea42b.png)
Feedback
Once you have downloaded the files, copy the .po and .mo files into the
installdir/apps/wordpress/htdocs/wp-content/languages directory. If this directory
does not exist, create it manually as follows:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Click on the "Settings -> General" tab located in the menu on the left.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 10/64
3/29/2018 Bitnami WordPress Installer
Scroll down until "Site Language". The newly-installed language should now appear
in the list. Select it and click "Save Changes".
(/images/img/apps/wordpress/wordpress-change-language-6ddea42b.png)
Feedback
Access the administration panel by browsing to http://localhost/wp-admin/.
How To Reset The WordPress Admin Password
From The Command Line?
Use the command below to reset the administrator password from the command line.
Remember to replace the NEWPASSWORD placeholder with your desired password.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 11/64
3/29/2018 Bitnami WordPress Installer
define('DISABLE_WP_CRON', true);
Then, add the cron task to the system. For example, this cron task will run the wp-cron.php
process every hour. You can add it using the following command:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
$ sudo crontab -e
0 * * * * su daemon -s /bin/sh -c "cd installdir/apps/wordpress/htdocs/; inst
alldir/php/bin/php -q wp-cron.php"
Feedback
How To Enable Multi-Site Support?
Use the Bitnami WordPress Multisite Stack (http://bitnami.com/stack/wordpress-multisite).
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 12/64
3/29/2018 Bitnami WordPress Installer
Feedback
(/images/img/apps/wordpress/wordpress-smtp1-fbb046d4.png)
Go to the "Settings -> WP Mail SMTP" panel and the "Settings" tab to configure the
SMTP settings of your email provider. Select "Other SMTP" as the mailer.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 13/64
3/29/2018 Bitnami WordPress Installer
(/images/img/apps/wordpress/wordpress-smtp2-d5d5ba42.png)
Feedback
Encryption: Use TLS encryption.
Authentication: On
SMTP Username: USERNAME@gmail.com
SMTP Password: PASSWORD
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 14/64
3/29/2018 Bitnami WordPress Installer
(/images/img/apps/wordpress/wordpress-smtp3-304121a5.png)
If you are using a different provider, remember to replace these values with the valid
data for your SMTP provider.
Feedback
Click "Save Settings" to save the changes.
Send a test email using the "Email Test" tab to ensure that everything is working
smoothly.
To configure the application to use other third-party SMTP services for outgoing email,
such as SendGrid or Mandrill, refer to the FAQ (/installer/faq#use_external_smtp_title).
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 15/64
3/29/2018 Bitnami WordPress Installer
Look for the section "Less secure apps" and then click on "Go to settings for less
secure apps".
If 2-step verification has not been enabled on the account, follow these steps:
Feedback
(/images/img/apps/common/google-security-a7ea177d.png)
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 16/64
3/29/2018 Bitnami WordPress Installer
If 2-step verification has been enabled on the account, you have to generate an app
password. Follow these steps:
Disable IMAP from the Gmail web server interface and enable it again.
Feedback
(/images/img/apps/common/google-imap-92233f17.png)
Browse to the "Plugins -> Install Plugins" menu item and then click the "Add New"
button to search for plugins.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 17/64
3/29/2018 Bitnami WordPress Installer
(/images/img/apps/wordpress/wordpress-install-plugins-1-125c60b5.png)
Once you find a plugin, click the "Install Now" button to download and install it.
(/images/img/apps/wordpress/wordpress-install-plugins-2-ecd6181d.png)
Feedback
Once the plugin is installed, activate it from the "Install Plugins" page. You can also
deactivate it later if you wish.
(/images/img/apps/wordpress/wordpress-install-plugins-3-a7a770d9.png)
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 18/64
3/29/2018 Bitnami WordPress Installer
When using the native installer, it is necessary to install a FTP server and specify your FTP
credentials.
(/images/img/apps/wordpress/wordpress-ftp-2b047ed1.png)
For more information about installing and managing plugins, such as Full API Access, refer
to the WordPress documentation (https://codex.wordpress.org/Managing_Plugins).
Feedback
How To Install The All-In-One WP Migration Plugin?
The following steps assume that
You are using the Bitnami WordPress Stack (not the WordPress Multisite) and
You are able to log in to the WordPress dashboard by visiting http://localhost/wp-
admin.php.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 19/64
3/29/2018 Bitnami WordPress Installer
(/images/img/apps/wordpress/wordpress-allinone-1-4b4f196c.png)
NOTE: If you are using a version of the Bitnami WordPress Stack lower than
v4.0, the "All-in-One WP Migration" plugin is not pre-installed. You must manually
install the plugin first following these instructions.
Feedback
connect to your machine through SSH, and run this command:
$ mkdir installdir/apps/wordpress/htdocs/wp-content/backup-db
Once you have done it, you must add the htaccess example provided by the plugin into the
htaccess.conf file and you must create an empty .htaccess file in the backup-db directory
to pass the plugin checks. To do it, run the commands below:
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 20/64
3/29/2018 Bitnami WordPress Installer
Finally, once you activate the plugin in your WordPress dashboard, you must ensure that in
the plugin DB Option the mysql and mysqldump paths are correct. For example, use the
paths installdir/mysql/bin/mysql and installdir/mysql/bin/mysqldump.
Feedback
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 21/64
3/29/2018 Bitnami WordPress Installer
(/images/img/apps/wordpress/wordpress-amp-1-d784a71c.png)
(/images/img/apps/wordpress/wordpress-amp-2-1b87c553.png)
You can verify that the plugin is working by adding /amp prefix to any WordPress post
URL, as shown below:
Feedback
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 22/64
3/29/2018 Bitnami WordPress Installer
(/images/img/apps/wordpress/wordpress-amp-3-7c5c51f7.png)
NOTE: As of this writing, the AMP plugin only works for WordPress posts and not
pages.
Feedback
Edit the WordPress configuration file for Apache (installdir/apps/wordpress/conf/httpd-
app.conf) and add the following line inside the Directory directive
...
<Directory installdir/apps/wordpress/htdocs/>
...
Header set Access-Control-Allow-Origin "*"
...
</Directory>
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 23/64
3/29/2018 Bitnami WordPress Installer
...
<Directory installdir/apps/wordpress/htdocs/wp-admin>
...
Header set Access-Control-Allow-Origin "\*"
Header set Access-Control-Allow-Methods "GET, OPTIONS, POST"
Header set Access-Control-Allow-Headers "origin, x-requested-with, content-typ
e, accept"
...
</Directory>
If the request is an OPTIONS request, the script exits with either access control headers
sent, or a 403 response if the origin is not allowed. By default, only the server where the
application is hosted is allowed (see installdir/apps/wordpress/htdocs/wp-
includes/http.php). For other request methods, you will receive a return value.
Akismet
All in One Seo Pack
All in One WP Migration
Google Analytics for WordPress
Jetpack
Feedback
Simple tags
WordPress MU Domain Mapping
WP Mail STMP
Bitnami WordPress Stack v4.5.1-0 removed several plugins, such as "Contact Form", "WP
Touch" and "Google XML Sitemaps". The functionality previously provided by those plugins
is now included in the Jetpack plugin in form of switchable features.
All the installed plugins are disabled by default. To enable them follow the instructions
below:
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 24/64
3/29/2018 Bitnami WordPress Installer
Look for the plugin you want to activate and click the "Activate" link that appears
below the plugin name.
(/images/img/apps/wordpress/wordpress-enable-plugins-1-30aeb3ac.png)
Feedback
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 25/64
3/29/2018 Bitnami WordPress Installer
(/images/img/apps/wordpress/wordpress-enable-plugins-2-00f4d8a1.png)
Feedback
How To Create A Full Backup Of WordPress?
The Bitnami WordPress Stack is self-contained and the simplest option for performing a
backup is to copy or compress the Bitnami stack installation directory. To do so in a safe
manner, you will need to stop all servers, so this method may not be appropriate if you
have people accessing the application continuously.
NOTE: If you want to create only a database backup, refer to these instructions for
MySQL (/installer/components/mysql#how-to-create-a-database-backup) and
PostgreSQL (/installer/components/postgresql#how-to-create-a-database-backup).
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 26/64
3/29/2018 Bitnami WordPress Installer
$ cd /your/directory
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Feedback
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
You should now download or transfer the application-backup.tar.gz file to a safe location.
Backup On Windows
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 27/64
3/29/2018 Bitnami WordPress Installer
Stop all servers using the shortcuts in the Start Menu or the graphical manager tool.
Create a compressed file with the stack contents. You can use a graphical tool like 7-
Zip or WinZip or just right-click the folder, click "Send to", and select the
"Compressed (zipped) folder" option.
Start all servers using the shortcuts in the Start Menu or the graphical manager tool.
$ cd /your/directory
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Feedback
Move the current stack to a different location:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 28/64
3/29/2018 Bitnami WordPress Installer
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
IMPORTANT: When restoring, remember to maintain the original permissions for the
files and folders. For example, if you originally installed the stack as the root user on
Linux, make sure that the restored files are owned by root as well.
Restore On Windows
Change to the directory containing your backup:
$ cd /your/directory
Feedback
Stop all servers using the shortcuts in the Start Menu or the graphical manager tool.
$ serviceinstall.bat
Create a safe folder named Backups in the desktop and move the current stack to it.
Remember to replace PATH with the right location of your folder:
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 29/64
3/29/2018 Bitnami WordPress Installer
Uncompress the backup file using a tool like 7-Zip or Winzip or just double-click the
.zip file to uncompress it, and move it to the original directory.
Install services by running the following commands from an elevated command
prompt:
$ cd installdir
$ serviceinstall.bat INSTALL
Start all servers using the shortcuts in the Start Menu or the graphical manager tool.
You can update WordPress easily from its administration panel, as follows:
Feedback
(/images/img/apps/wordpress/wordpress-upgrade-1-bc5b77db.png)
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 30/64
3/29/2018 Bitnami WordPress Installer
(/images/img/apps/wordpress/wordpress-upgrade-2-24312e77.png)
Bitnami images come with SSL support already pre-configured and with a dummy
certificate in place. Although this dummy certificate is fine for testing and development
purposes, you will usually want to use a valid SSL certificate for production use. You can
either generate this on your own (explained here) or you can purchase one from a
commercial certificate authority.
Feedback
Once you obtain the certificate and certificate key files, you will need to update your server
to use them. Follow these steps to activate SSL support:
Use the table below to identify the correct locations for your certificate and
configuration files.
Variable Value
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 31/64
3/29/2018 Bitnami WordPress Installer
Variable Value
Copy your SSL certificate and certificate key file to the specified locations.
NOTE: If you use different names for your certificate and key files, you should
reconfigure the SSLCertificateFile and SSLCertificateKeyFile directives in the
corresponding Apache configuration file to reflect the correct file names.
If your certificate authority has also provided you with a PEM-encoded Certificate
Authority (CA) bundle, you must copy it to the correct location in the previous table.
Then, modify the Apache configuration file to include the following line below the
SSLCertificateKeyFile directive. Choose the correct directive based on your scenario
and Apache version:
Variable Value
Feedback
Directive to include (Apache SSLCertificateChainFile
< v2.4.8) "installdir/apache2/conf/server-ca.crt"
NOTE: If you use a different name for your CA certificate bundle, you should
reconfigure the SSLCertificateChainFile or SSLCACertificateFile directives in the
corresponding Apache configuration file to reflect the correct file name.
Once you have copied all the server certificate files, you may make them readable by
the root user only with the following commands:
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 32/64
3/29/2018 Bitnami WordPress Installer
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Open port 443 in the server firewall. Refer to the FAQ (/installer/faq#how-to-open-
the-server-ports-for-remote-access) for more information.
You should now be able to access your application using an HTTPS URL.
Feedback
NOTE: OpenSSL will typically already be installed on Linux and Mac OS X. If not
installed, install it manually using your operating system's package manager.
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 33/64
3/29/2018 Bitnami WordPress Installer
Create a certificate:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
IMPORTANT: Enter the server domain name when the above command asks for
the "Common Name".
Send cert.csr to the certificate authority. When the certificate authority completes
their checks (and probably received payment from you), they will hand over your new
certificate to you.
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Feedback
-days 365
Back up your private key in a safe location after generating a password-protected
version as follows:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 34/64
3/29/2018 Bitnami WordPress Installer
Note that if you use this encrypted key in the Apache configuration file, it will be
necessary to enter the password manually every time Apache starts. Regenerate the
key without password protection from this file as follows:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Windows
NOTE: OpenSSL is not typically installed on Windows. Before following the steps
below, download and install a binary distribution of OpenSSL
(https://wiki.openssl.org/index.php/Binaries).
$ set OPENSSL_CONF=C:\OPENSSL-DIRECTORY\bin\openssl.cfg
Feedback
Change to the bin/ sub-directory of the OpenSSL installation directory. Replace the
OPENSSL-DIRECTORY placeholder in the command below with the correct location.
$ cd C:\OPENSSL-DIRECTORY\bin
Create a certificate:
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 35/64
3/29/2018 Bitnami WordPress Installer
IMPORTANT: Enter the server domain name when the above command asks for
the "Common Name".
Send cert.csr to the certificate authority. When the certificate authority completes
their checks (and probably received payment from you), they will hand over your new
certificate to you.
Note that if you use this encrypted key in the Apache configuration file, it will be
necessary to enter the password manually every time Apache starts. Regenerate the
Feedback
key without password protection from this file as follows:
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 36/64
3/29/2018 Bitnami WordPress Installer
RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^/(.*) https://%{SERVER_NAME}/$1 [R,L]
Open port 443 in the server firewall. Refer to the FAQ (/installer/faq#how-to-open-
the-server-ports-for-remote-access) for more information.
The access_log file is used to track client requests. When a client requests a
document from the server, Apache records several parameters associated with the
request in this file, such as: the IP address of the client, the document requested, the
HTTP status code, and the current time.
The error_log file is used to record important events. This file includes error
messages, startup messages, and any other significant events in the life cycle of the
server. This is the first place to look when you run into a problem when using
Apache.
Feedback
If no error is found, you will see a message similar to:
Syntax OK
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 37/64
3/29/2018 Bitnami WordPress Installer
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
If you have configured your machine to use a static domain name or IP address, you
should rename or remove the installdir/apps/wordpress/bnconfig file.
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
NOTE: Be sure that your domain is propagated. Otherwise, this will not work. You can
verify the new DNS record by using the Global DNS Propagation Checker
(https://www.whatsmydns.net/) and entering your domain name into the search field.
You can also change your hostname by modifying it in your hosts file. Enter the new
hostname using your preferred editor.
Feedback
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Add a new line with the IP address and the new hostname. Here's an example.
Remember to replace the IP-ADDRESS and DOMAIN placeholders with the correct
IP address and domain name.
IP-ADDRESS DOMAIN
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 38/64
3/29/2018 Bitnami WordPress Installer
$ mysql -u root -p
You will be prompted to enter the root user password. This is the same as the application
password (/installer/faq#how-to-find-application-credentials).
Feedback
Replace the NEW_PASSWORD placeholder with the actual password you wish to set.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 39/64
3/29/2018 Bitnami WordPress Installer
If your stack ships MySQL v5.7.x, use the following content instead of that shown
above:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Feedback
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 40/64
3/29/2018 Bitnami WordPress Installer
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
$ rm /home/bitnami/mysql-init
Feedback
it to a new value:
Stop the MySQL server using the graphic manager tool. Refer to the how to start or
stop the services section.
Check the MySQL version:
installdir\mysql\bin\mysqladmin.exe –version
Create a file named mysql-init.txt with the content shown below depending on your
MySQL version (replace NEW_PASSWORD with the password you wish to use):
MySQL 5.6.x or earlier:
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 41/64
3/29/2018 Bitnami WordPress Installer
Start MySQL server with the following command. Remember to replace PATH with
the location in which you have saved the mysql-init.txt file:
The --init file option is used by the server for executing the content of the mysql-
init.txt file at startup, it will change each root account password.
The --defaults-file option is specified since you have installed MySQL using the
Bitnami installer.
The --console option (optional) has been added in order to show the server
output at the console window rather than in the log file.
Feedback
http://127.0.0.1/phpmyadmin.
The username is root for phpMyAdmin, and the password is the one specified by you
during the installation process.
For example, to modify the default upload limit for PHP, update the PHP configuration file
following these instructions.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 42/64
3/29/2018 Bitnami WordPress Installer
After modifying the PHP configuration file, restart both Apache and PHP-FPM for the
changes to take effect:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Feedback
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Install the Wordfence Security plugin via the WordPress dashboard and run a scan of your
WordPress installation, as follows:
(/images/img/apps/wordpress/wordpress-wordfence-1-b46d2ea1.png)
Click the "Activate plugin" link. A new entry should now appear in the left navigation
menu.
Feedback
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 44/64
3/29/2018 Bitnami WordPress Installer
(/images/img/apps/wordpress/wordpress-wordfence-2-8301682d.png)
Click the "Wordfence" menu item and then the "Start a Wordfence Scan" option.
Wait until the scan ends.
Feedback
(/images/img/apps/wordpress/wordpress-wordfence-3-0093bfc9.png)
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 45/64
3/29/2018 Bitnami WordPress Installer
IMPORTANT: Since the Bitnami WordPress Stack 4.4.2-3, the pingback feature in the
XML-RPC module has been disabled.
Other XML-RPC features continue working as before so you can still publish content in
your WordPress blog/website from Web clients or smartphone apps.
Feedback
return $methods;
});
A brute force amplification attack on your WordPress installation. Read more about it
at this Sucuri blog post about DDoS attacks on WordPress
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 46/64
3/29/2018 Bitnami WordPress Installer
(https://blog.sucuri.net/2015/10/brute-force-amplification-attacks-against-wordpress-
xmlrpc.html).
A Distributed Denial of Service (DDoS) attack on other WordPress installations
abusing the pingback feature. Read more about it at this Sucuri blog post about
DDoS attacks on WordPress (https://blog.sucuri.net/2014/03/more-than-162000-
wordpress-sites-used-for-distributed-denial-of-service-attack.html).
If most of the entries in your logs come from the same IP address, it's likely your site is
either under a brute force amplification attack or being used to launch a pingback attack
towards a different site. If the entries come from different IP addresses, your site is
probably the victim of a pingback attack.
Please keep in mind that none of these attacks are related to a security issue, but are the
result of abusing pingbacks and the XML-RPC mechanism.
The DDoS attack became more popular after WordPress version 3.5 was released with the
pingback feature enabled by default.
Current countermeasures:
Since Bitnami WordPress Stack 4.4, the brute force amplification attack is no longer
exploitable, although a common brute force attack is still possible.
Since Bitnami WordPress Stack 4.4.2-3, the pingback feature has been disabled.
This means a malicious agent won't be able to use your WordPress to perform DDoS
attacks on other instances.
We also ship the Jetpack plugin, which can help protect a site against Brute Force
Feedback
attacks thanks to the Protect module. You can find more information at Jetpack
website (https://jetpack.com/support/security-features/). The plugin is inactive by
default, you should enable it using the WordPress admin panel.
Even with these actions, you will still be vulnerable to common brute force attacks using
the XML-RPC module.
Apart from these, there are at least two more countermeasures you can apply, although
each one has their own drawbacks:
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 47/64
3/29/2018 Bitnami WordPress Installer
Disable XML-RPC: It will avoid both types of attacks but smartphone apps, remote
publishing and some plugins won't work. You can find more information at this blog
post about disabling XML-RPC in WordPress
(http://www.wpbeginner.com/plugins/how-to-disable-xml-rpc-in-wordpress/).
Block the offending IP addresses: This should be considered a fragile, short-term
solution.
Troubleshooting WordPress
I Cannot Access My WordPress Application
First, check that the URL is correct and the servers are running. If the server has recently
restarted, the domain name and IP address could have changed. Check in the server
administration panel that you are trying to access the correct URL.
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Feedback
If the servers are not running, check the web and database servers log files.
WordPress Cannot Load Images Or CSS
This usually happens when the server's IP address changes. WordPress saves the IP
address or the domain name in the database so if the IP address changes, it is necessary
to update the database as well.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 48/64
3/29/2018 Bitnami WordPress Installer
(/images/img/apps/wordpress/issue-css-wordpress-e40e52f6.png)
Use the MySQL command-line client to change the exact field in the database:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Feedback
$ sudo mysql -u root -p -e "USE bitnami_wordpress; UPDATE wp_options SET optio
WordPress Tries To Contact External Sites When I Log In. What Can I
Do?
WordPress tries to contact external resources such as api.wordpress.com
(http://api.wordpress.com), wordpress.org (http://wordpress.org), planet.wordpress.org
(http://planet.wordpress.org) or blogsearch.google.com (http://blogsearch.google.com).
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 49/64
3/29/2018 Bitnami WordPress Installer
Most of these connections are performed to feed the widgets in the dashboard and are
completely harmless. To prevent them, remove the widgets by selecting the "Screen
Options" menu in the top right corner:
(/images/img/apps/wordpress/screen-options-060ccadd.png)
Feedback
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 50/64
3/29/2018 Bitnami WordPress Installer
(/images/img/apps/wordpress/dashboard-widgets-d7f09b78.png)
Note some external connections may still be seen when WordPress or its plugins check for
updates.
Feedback
permissions (e.g. WP Super Cache).
If you are having permission issues while installing, activating or updating a plugin, log into
your server and execute the following command:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Please retrieve the previous permissions configuration after activating the plugin.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 51/64
3/29/2018 Bitnami WordPress Installer
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Since Bitnami WordPress Stack 4.5-1, we ship WordPress with the latest version of PHP7.
WordPress Core already supports PHP7 but some plugins may not support it yet. If you
experience any issue with plugins related to this, check that the plugin you are installing
already supports PHP7 or needs to be updated.
We also provide the latest version of WordPress, bundled with the latest version of PHP
5.6 that will avoid possible compatibility issues with plugins not prepared for PHP7. This
version should be considered as legacy, WordPress recommends to move to PHP7.
Feedback
UPDATE wp_options SET option_value = 'a:0:{}' WHERE option_name = 'active_plug
ins';
You can connect to the bitnami_wordpress database using the user bn_wordpress and the
random password located in the installdir/apps/wordpress/htdocs/wp-config.php file
running the command below:
After that, restart all the services for changes to take effect running the command below
and try to connect to your website again:
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 52/64
3/29/2018 Bitnami WordPress Installer
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
If you want to activate the plugin that caused you the issue, you need to upgrade it first and
then connect to your server via SSH and execute:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
After that, you should be able to activate the plugin from the WordPress Admin Panel.
Feedback
wordpress_instance_name NEW_BLOG_NAME option.
First, download the module, and then run the download file with a special parameter.
Windows
Linux
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 53/64
3/29/2018 Bitnami WordPress Installer
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Mac OS X
Once you have the module installed, you will be able to access it through
http://localhost/NEW_BLOG_NAME.
Feedback
The most common reason for performance issues is lack of any caching. Turning it on,
which for most Bitnami stacks is not that difficult, dramatically improve the server
performance.
IMPORTANT: To apply each cache plugin, it is assumed that your WordPress instance
is already running at the domain root URL, such as at http://mywp.bitnamiapp.com/ or
http://example.com/. Please use the bnconfig tool to accomplish this.
W3 Total Cache
Follow these steps:
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 54/64
3/29/2018 Bitnami WordPress Installer
Troubleshooting
Installation
During installation, W3 Total Cache may display an error stating that some Apache
modules are not detected on the server, when they are in fact installed. This error is a
known bug in the W3 Total Cache plugin (https://support.plesk.com/hc/en-
us/articles/115005108854-W3-Total-Cache-plugin-shows-apache-modules-as-not-
detected-) and may be safely ignored.
Debugging
If you have problems configuring W3 Total Cache, try to enable "Debug mode". Browse to
the W3 Total Cache admin and select at least the "Page Cache" option in the "Debug"
section. Then, browse to one of your Web pages and check the source code. There should
be debugging information at the end, which you can use to check if caching works
properly.
If WordPress is installed at the /wordpress path, there may be a conflict between the
permalink rewrites and the ones added by the W3 Total Cache plugin. To resolve this,
ensure that all the Rewrite entries are removed or commented out in the
installdir/apps/wordpress/conf/httpd-app.conf file.
Feedback
WP Super Cache
Follow these steps:
Download the plugin from https://wordpress.org/plugins/wp-super-cache/
(https://wordpress.org/plugins/wp-super-cache/).
Upload this directory to your plugins directory. It will create a
installdir/apps/wordpress/htdocs/wp-content/plugins/wp-super-cache/ directory.
If you are using WordPress MU or WordPress Multisite, activate it "network wide".
Browse to "Settings -> WP Super Cache" and enable caching.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 55/64
3/29/2018 Bitnami WordPress Installer
<Directory "installdir/apps/wordpress/conf/">
# BEGIN WPSuperCache
<IfModule mod_rewrite.c>
RewriteEngine On
...
# END WPSuperCache
</Directory>
<Directory "installdir/apps/wordpress/htdocs/wp-content/cache">
# BEGIN supercache
<IfModule mod_mime.c>
<FilesMatch "\.html\.gz$">
ForceType text/html
FileETag None
</FilesMatch>
AddEncoding gzip .gz
AddType text/html .gz
</IfModule>
Feedback
<IfModule mod_deflate.c>
SetEnvIfNoCase Request_URI \.gz$ no-gzip
</IfModule>
<IfModule mod_headers.c>
Header set Cache-Control 'max-age=3, must-revalidate'
</IfModule>
<IfModule mod_expires.c>
ExpiresActive On
ExpiresByType text/html A3
</IfModule> `` # END supercache
</Directory>
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 56/64
3/29/2018 Bitnami WordPress Installer
Troubleshooting
Debugging
If you have problems configuring WP Super Cache, try to enable "Debug mode". Browse to
the WP Super Cache settings, click on "Debug" and enable the "debugging" option. One
you have saved the changes, you will find the current log file at the top of the web page.
Prior installation
If you have WP-Cache installed already, please disable it. Edit wp-config.php and make
sure that the WP_CACHE and WPCACHEHOME defines are deleted. Remove the files
installdir/apps/wordpress/htdocs/wp-content/wp-cache-config.php and
installdir/apps/wordpress/htdocs/wp-content/advanced-cache.php. These will be recreated
when you install this plugin.
Quick Cache
Follow these steps:
Troubleshooting
Permission issues
Feedback
write-access to this directory. Permissions need to be 755 or higher.
Permissions: Please check permissions on /wp-config.php . Quick Cache needs wr
ite-access to this file. Permissions need to be 755 or higher.
This arises because the default ownership of the application files is usually set to the
bitnami user and daemon group, so users can edit the files directly as the bitnami user and
the Web server is also able to read them. In this case, when the Web server needs to be
able to modify any files or directories, it becomes necessary give write permissions to the
group too.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 57/64
3/29/2018 Bitnami WordPress Installer
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Minify
This plugin uses the Minify engine to combine and compress JS and CSS files to improve
page load time. There are several plugins for the same purpose: Minify
(http://wordpress.org/extend/plugins/minify/), WP Minify
(http://wordpress.org/extend/plugins/wp-minify/) or Better WordPress Minify
(http://wordpress.org/extend/plugins/bwp-minify/). You can install one of them and it should
improve your page load time. In all cases it is necessary to have WordPress running in the
root URL.
Feedback
NOTE: The steps below assume that WordPress is already running at the root URL of
the server, such as at http://wordpress.example.com/.
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 58/64
3/29/2018 Bitnami WordPress Installer
Note: Only use sudo if the stack was installed as root. Remember to load
the Bitnami stack environment (instructions) before running the
commands below.
Note: Only use sudo if the stack was installed as root. Remember to load
the Bitnami stack environment (instructions) before running the
commands below.
Feedback
$ sudo cp wordpress.v4 installdir/varnish/etc/varnish/default.vcl
$ sudo sed -i 's/port\s*=\s*"[^"]*"/port = "80"/g' installdir/varnis
h/etc/varnish/default.vcl
Restart Varnish:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 59/64
3/29/2018 Bitnami WordPress Installer
Check if your website is being served properly by Varnish on port 81 by adding :81 to
the domain name in your browser - for example, http://xyz.bitnamiapp.com:81/. There
is also a Web page to check Varnish status and obtain information about the
configuration, at http://www.isvarnishworking.com/
(http://www.isvarnishworking.com/).
If Varnish is working correctly, switch the Apache and Varnish ports and activate
Varnish on port 80:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
Feedback
$ sudo sed -i 's/VARNISH_PORT=.*$/VARNISH_PORT=80/g' installdir/varnish/s
cripts/ctl.sh
$ sudo installdir/ctlscript.sh restart
wordpress.vcl (/downloads/components/varnish/wordpress.vcl)
wordpress.v4 (/downloads/components/varnish/wordpress.v4)
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 60/64
3/29/2018 Bitnami WordPress Installer
Uncomment and update the Alias directives to reflect the new path. For example, to
move WordPress to the /blog path, update the file to look like this:
Feedback
Modify them to reflect the new path, as below:
Restart Apache:
Note: Only use sudo if the stack was installed as root. Remember to load the
Bitnami stack environment (instructions) before running the commands below.
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 61/64
3/29/2018 Bitnami WordPress Installer
NOTE: The wp utility is also included in the system path so you can run the command
without specifying the whole path to the file.
Related Guides
Migrate Data From One WordPress Instance to Another (/installer/how-to/migrate-
wordpress)
Troubleshoot WordPress Issues (/installer/how-to/troubleshoot-wordpress-issues)
Feedback
Bitnami Documentation
FAQs
How to find application credentials? (/general/faq#find_credentials)
How to connect to the server through SSH? (/general/faq#connect_ssh)
How to upload files to the server with SFTP? (/general/faq#upload_files)
How to open the server ports for remote access? (/general/faq#open_firewall)
How to configure your application to use a third-party SMTP service for outgoing email?
(/general/faq#use_external_smtp_title)
How to block a suspicious IP address? (/general/faq#block_suspicious_ip)
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 62/64
3/29/2018 Bitnami WordPress Installer
Platform Documentation
Google Cloud Platform (/google)
AWS Cloud (/aws)
Oracle Cloud Infrastructure Classic (/oracle)
Microsoft Azure (/azure)
Bitnami Cloud Hosting (/bch)
CenturyLink Cloud (/centurylink)
1&1 Cloud Platform (/1and1)
Huawei Cloud (/huawei)
Windows / Linux / MacOS (/installer)
Virtual Machines (/virtual-machine)
Containers (/containers)
Kubernetes (/kubernetes)
General Documentation
Bitnami Application Stacks (/general/apps)
Bitnami Infrastructure Stacks (/general/infrastructure)
How-To Guides (/general/how-to)
Bitnami Components (/general/components)
Security Notices (/general/security)
© Bitnami 2018
Apps
Applications (https://bitnami.com/stacks)
Feedback
Add-ons (https://bitnami.com/addons)
Vote! (https://bitnami.com/contest)
What we do
Who we are
About (https://bitnami.com/about-us)
Support
Documentation (https://bitnami.com/support)
Forums (https://community.bitnami.com)
Helpdesk (http://helpdesk.bitnami.com)
Webinars (https://bitnami.com/webinars)
Feedback
https://docs.bitnami.com/installer/apps/wordpress/#first_steps 64/64