diff --git a/docs/platform/one-click/deploying-wordpress-with-one-click-apps/index.md b/docs/platform/one-click/deploying-wordpress-with-one-click-apps/index.md new file mode 100644 index 00000000000..45611b10f1d --- /dev/null +++ b/docs/platform/one-click/deploying-wordpress-with-one-click-apps/index.md @@ -0,0 +1,103 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Deploy a WordPress website on Linode using One-Click Apps.' +keywords: ['wordpress','wp cli','one-click apps', 'cms'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-03-27 +modified: 2019-03-27 +modified_by: + name: Linode +title: "Deploy WordPress with One-Click Apps" +contributor: + name: Linode +external_resources: +- '[WordPress Codex (Documentation)](https://codex.wordpress.org/)' +--- + +## WordPress One-Click App + +With 60 million users around the globe, WordPress provides an industry standard for content-focused websites such as blogs, news sites, and personal websites. Its focus on best-in-class usability and flexibility, makes it possible to have a customized website up and running in minutes. + +### Deploy a WordPress One-Click App + +{{< content "deploy-one-click-apps" >}} + +The [WordPress Options](#wordpress-options) section of this guide provides details on all available configuration options for this app. + +### WordPress Options + +You can configure your WordPress App by providing values for the following fields: + +| **Field** | **Description** | +|:--------------|:------------| +| **Admin Username** | Username for your WordPress admin user. *Required*. | +| **Admin Password** | Password for your WordPress admin user. *Required*. | +| **E-Mail Address** | E-Mail address for your WordPress admin user. *Required*. | +| **Website Title** | Your WordPress site's title. *Advanced Configuration*. | +| **SSH Key** | Your SSH [public key](/docs/security/authentication/use-public-key-authentication-with-ssh/). The public key will be stored in the /root/.ssh/authorized_keys file on your Linode, and you will be able to use it to login as root over SSH. *Advanced Configuration*. | + +### Linode Options + +After providing the app specific options, provide configurations for your Linode server: + +| **Configuration** | **Description**                                                                                                     | +|--------------|------------| +| **Select an Image** | Debian 9 is currently the only image supported by WordPress One-Click Apps, and it is pre-selected on the Linode creation page. *Required*. | +| **Region** | The region where you would like your Linode to reside. In general, it's best to choose a location that's closest to you. For more information on choosing a DC, review the [How to Choose a Data Center](/docs/platform/how-to-choose-a-data-center) guide. You can also generate [MTR reports](/docs/networking/diagnostics/diagnosing-network-issues-with-mtr/) for a deeper look at the network routes between you and each of our data centers. *Required*. | +| **Linode Plan** | Your Linode's [hardware resources](/docs/platform/how-to-choose-a-linode-plan/#hardware-resource-definitions). WordPress is an extremely flexible CMS that can be supported on any size Linode, but we suggest you build your WordPress app on a Linode plan that reflects how much content you plan on featuring and how much traffic you expect on your site. For small websites, a 1GB Nanode is sufficient. If you decide that you need more or fewer hardware resources after you deploy your app, you can always [resize your Linode](/docs/platform/disk-images/resizing-a-linode/) to a different plan. *Required*. | +| **Linode Label** | The name for your Linode, which must be unique between all of the Linodes on your account. This name will be how you identify your server in the Cloud Manager’s Dashboard. *Required*. | +| **Root Password** | The primary administrative password for your Linode instance. This password must be provided when you log in to your Linode via SSH. It must be at least 6 characters long and contain characters from two of the following categories: lowercase and uppercase case letters, numbers, and punctuation characters. Your root password can be used to perform any action on your server, so make it long, complex, and unique. *Required*. | + +When you've provided all required Linode Options, click on the **Create** button. **Your WordPress app will complete installation anywhere between 2-5 minutes after your Linode has finished provisioning**. + +## Getting Started After Deployment + +### Access Your WordPress Site + +After WordPress has finished installing, you will be able to access your WordPress site by copying your Linode's IPv4 address and entering it in the browser of your choice. To find your Linode's IPv4 address: + +1. Click on the **Linodes** link in the sidebar. You will see a list of all your Linodes. + +1. Find the Linode you just created when deploying your app and select it. + +1. Navigate to the **Networking** tab. + +1. Your IPv4 address will be listed under the **Address** column in the **IPv4** table. + +1. Copy and paste the IPv4 address into a browser window. You should see your WordPress site's home page. + +1. Once you have accessed your WordPress site via the browser, you can log in to the WordPress administrative interface and start personalizing your theme, creating posts, and configuring other parts of your site. + + The address of the WordPress login page is `http://< your IP address >/wp-login.php`. Or, you can click on the log in link that's visible on your site's home page, as highlighted below. Enter the credentials you previously specified in the **Admin Username** and **Admin Password** fields when you deployed the app. + + ![Log in to your WordPress site.](wordpress-login.png) + +### Set up a Domain for your Site + +If you own a domain name, you can assign it (or a subdomain) to your WordPress site. Specifically, you will need to set up an [*A record*](/docs/networking/dns/dns-records-an-introduction/#a-and-aaaa) that's associated with your Linode's IP address. To learn how to set up DNS records in the Cloud Manager, review the [DNS Manager](/docs/platform/manager/dns-manager/) guide. For more general information about how DNS works, review the [DNS Records: An Introduction](/docs/networking/dns/dns-records-an-introduction/) guide. + +Once you have set up DNS for your site, you will be able to visit it by entering your domain or subdomain in your browser. At this point, you should also update the [WordPress Address and Site URL settings](https://codex.wordpress.org/Changing_The_Site_URL) for your site: + +1. Log in to your WordPress site's admin interface as described in the previous section. + +1. Click on the **Settings** link in the sidebar, then click on the **General** option from the dropdown menu that appears. + + ![WordPress general settings menu option highlighted](wordpress_general_settings_menu_option_highlighted.png "WordPress general settings menu option highlighted") + +1. The **General Settings** form will appear. Update the **WordPress Address** and **Site URL** fields with the domain or subdomain you assigned to your site. Specifically, the value for both fields should be `http://example.com`, where `example.com` is replaced by your domain or subdomain. + +1. Click the **Save Changes** button at the bottom of the form. + +### Software Included + +The WordPress One-Click App will install the following required software on your Linode: + +| **Software** | **Description** | +|:--------------|:------------| +| [**MySQL Server**](https://www.mysql.com/) | Relational database. | +| [**PHP 7**](https://www.php.net/) | WordPress is written in PHP and requires PHP to operate. | +| [**Apache HTTP Server**](https://httpd.apache.org/) | Web server used to serve the WordPress site. | +| [**WordPress**](https://wordpress.org/) | Content management system. | +| [**WP CLI**](https://wp-cli.org/) | The command line interface for WordPress. | \ No newline at end of file diff --git a/docs/platform/one-click/deploying-wordpress-with-one-click-apps/wordpress-login.png b/docs/platform/one-click/deploying-wordpress-with-one-click-apps/wordpress-login.png new file mode 100644 index 00000000000..75597086a90 Binary files /dev/null and b/docs/platform/one-click/deploying-wordpress-with-one-click-apps/wordpress-login.png differ diff --git a/docs/platform/one-click/deploying-wordpress-with-one-click-apps/wordpress_general_settings_menu_option_highlighted.png b/docs/platform/one-click/deploying-wordpress-with-one-click-apps/wordpress_general_settings_menu_option_highlighted.png new file mode 100644 index 00000000000..51db674dea5 Binary files /dev/null and b/docs/platform/one-click/deploying-wordpress-with-one-click-apps/wordpress_general_settings_menu_option_highlighted.png differ