diff --git a/ci/vale/dictionary.txt b/ci/vale/dictionary.txt index 8fefe935b6f..1c345a189f0 100644 --- a/ci/vale/dictionary.txt +++ b/ci/vale/dictionary.txt @@ -87,6 +87,7 @@ bashrc bc berkshelf binlog +biomes bitbucket bitrate blocklists @@ -371,6 +372,7 @@ fediverse fetchmail fetchmailrc ff02 +fi fiiiile file1 filebeat @@ -406,6 +408,7 @@ fstab galera gamemode gamepad +gamepedia gameplay gandi gatsby @@ -476,6 +479,7 @@ h4x0r123 hackage hadoop halls3 +hapis haproxy hardcoded hardcopy @@ -652,6 +656,7 @@ kubernetes kubespray lambdabunker laravel +largebiomes launchd lbmethod lda @@ -764,6 +769,7 @@ microservices microsystems microweb minecraft +mineshafts miniconda miniconda3 minification @@ -778,6 +784,7 @@ mitigations mkdir mnesia moby +moddable modsecurity mongodb monit @@ -1083,6 +1090,7 @@ resharding resilvering resolv resolvconf +respawn resque restapi retpoline @@ -1134,6 +1142,7 @@ sasl2 saslauth saslauthd sasldb +savas sbackup sbin sbopkg @@ -1353,7 +1362,9 @@ tw txt txz ucd +udp ufw +udp ui uidl umount diff --git a/docs/platform/billing-and-support/billing-and-payments/index.md b/docs/platform/billing-and-support/billing-and-payments/index.md index fbabe06d70f..e1a1e317e03 100644 --- a/docs/platform/billing-and-support/billing-and-payments/index.md +++ b/docs/platform/billing-and-support/billing-and-payments/index.md @@ -180,7 +180,6 @@ You can cancel your account and receive a refund. Here's how: 1. Log in to the [Classic Linode Manager](http://manager.linode.com). 1. Click the **Accounts** link. 1. At the bottom of the page, select the **Cancel this Account** link. The cancel account webpage appears. -1. If you have a prepaid service credit on your account at the time of cancellation, you are entitled to a refund, minus a $5 processing fee. To request a refund, enter a note in the text field. Note that credits from sources other than prepaying cannot be refunded. 1. Select the confirmation checkbox. 1. Click the **Cancel this Account Immediately** checkbox. @@ -189,7 +188,3 @@ Your account will be canceled and all of your services will be deactivated. {{< note >}} You do not have to cancel your account to prevent recurring charges. Instead, you can remove all Linodes and services from your account via the **Linodes** tab in the Cloud Manager. This will allow you to retain your Linode account. If you use Longview with non-Linode services, or want to keep your account name and history, you may find this to be a useful option. See the [Removing Services](#removing-services) section for more information. {{< /note >}} - -## Prepaid Billing - -If you created your account before hourly billing was first available and have not converted to hourly billing, your account uses prepaid billing. Review the legacy [Prepaid Billing](/docs/platform/billing-and-support/prepaid-billing-and-payments-legacy/) guide for more information on how your bills and invoices are prepared. diff --git a/docs/platform/billing-and-support/upgrade-to-hourly-billing/index.md b/docs/platform/billing-and-support/upgrade-to-hourly-billing/index.md index bb21664bf3c..dd7467d056a 100644 --- a/docs/platform/billing-and-support/upgrade-to-hourly-billing/index.md +++ b/docs/platform/billing-and-support/upgrade-to-hourly-billing/index.md @@ -11,6 +11,7 @@ modified_by: name: Linode published: 2017-02-15 title: 'Upgrade to Hourly Billing' +deprecated: true --- This guide will show you how to upgrade your legacy prepaid billing Linode account to use Hourly billing. For more information on Hourly billing, see our [Billing Guide](/docs/platform/billing-and-support/billing-and-payments/). @@ -51,4 +52,4 @@ You will no longer receive the annual discount when you switch to Hourly billing [![Please note the annual discounts will go away when converting to Hourly.](convert-to-hourly-annual-small.png)](convert-to-hourly-annual.png) -On March 31st all prepaid accounts will be automatically converted to to Hourly billing. +On March 31st, 2019 all prepaid accounts will be automatically converted to to Hourly billing. diff --git a/docs/platform/one-click/_index.md b/docs/platform/one-click/_index.md new file mode 100644 index 00000000000..d34151bdc89 --- /dev/null +++ b/docs/platform/one-click/_index.md @@ -0,0 +1,11 @@ +--- +author: + name: Linode + email: docs@linode.com +description: 'Use One-Click Apps to easily deploy a Linode with pre-installed software, like WordPress, Minecraft, and OpenVPN.' +keywords: ['one-click', 'apps'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-03-26 +title: One-Click Apps +show_in_lists: true +--- diff --git a/docs/platform/one-click/deploy-gitlab-with-one-click-apps/gitlab-reset-password.png b/docs/platform/one-click/deploy-gitlab-with-one-click-apps/gitlab-reset-password.png new file mode 100644 index 00000000000..945f877d449 Binary files /dev/null and b/docs/platform/one-click/deploy-gitlab-with-one-click-apps/gitlab-reset-password.png differ diff --git a/docs/platform/one-click/deploy-gitlab-with-one-click-apps/index.md b/docs/platform/one-click/deploy-gitlab-with-one-click-apps/index.md new file mode 100644 index 00000000000..32e5eeb9696 --- /dev/null +++ b/docs/platform/one-click/deploy-gitlab-with-one-click-apps/index.md @@ -0,0 +1,126 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Deploy GitLab on Linode using One-Click Apps.' +keywords: ['gitlab','one-click apps','version control','git'] +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 GitLab with One-Click Apps" +contributor: + name: Linode +external_resources: +- '[GitLab Adminstrator Documentation](https://docs.gitlab.com/ee/administration/)' +--- +## GitLab One-Click App + +GitLab is a complete solution for all aspects of your software development. At its core, GitLab serves as your centralized remote Git repository. GitLab also features built-in tools that represent every task in your development workflow, from planning to testing to releasing. + +Self-hosting your software development with GitLab offers total control of your codebase. At the same time, its familiar interface will ease collaboration for you and your team. GitLab is the most popular self-hosted Git repository software, so you'll benefit from a robust set of integrated tools and an active community. + +### Deploy a GitLab One-Click App + +{{< content "deploy-one-click-apps">}} + +### GitLab Options + +You can configure your GitLab App by providing values for the following fields: + +| **Field** | **Description** | +|:--------------|:------------| +| **Domain** | Your GitLab site's domain name. This domain will also be used by Postfix to send mail. Setting a value for this field will not automatically set up DNS for your app, so be sure to follow the DNS instructions in the [Access your GitLab Site](#access-your-gitlab-site) section. If you do not have a domain name, you can leave this field blank and Postfix will use your Linode's default Reverse DNS to send email instead (i.e. `gitlab@li926-227.members.linode.com`). *Advanced Configuration*. | +| **SSH public 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. *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 the GitLab One-Click App, 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). We recommend that you use, at minimum, an **8GB Linode plan** for your GitLab server. For more information on GitLab's system requirements see their [official documentation](https://docs.gitlab.com/ee/install/requirements.html). 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 GitLab app will complete installation anywhere between 3-7 minutes after your Linode has finished provisioning**. + +## Getting Started after Deployment + +### Access your GitLab Site + +After GitLab has finished installing, you will be able to access your GitLab site over `http://` with your Linode's IPv4 address or the domain name entered when deploying your GitLab One-Click App. + +1. Access your GitLab instance: + + **With your Linode's IP Address** + + You will be able to access your GitLab 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. Ensure you are using `http://`. + + **With a Domain Name** + + If you deployed your GitLab One-Click App with a value set for the **Domain** field, you will need to separately set up DNS for your app. Specifically, you'll need to create an [*A record*](/docs/networking/dns/dns-records-an-introduction/#a-and-aaaa) associated with the IPv4 address for your Linode. Review the [DNS Manager](/docs/platform/manager/dns-manager/) guide for instructions on setting up DNS records. + + Once your DNS records are created (and the changes have [propagated to your internet service provider](/docs/platform/manager/dns-manager/#wait-for-propagation)), you can then enter the domain name in a browser window to access your GitLab site. Ensure you are using `http://` when visiting your site. + + {{< note >}} +For more general information about how DNS works, review the [DNS Records: An Introduction](/docs/networking/dns/dns-records-an-introduction/) guide. +{{< /note >}} + +1. Once you have accessed your GitLab site, you will be brought to GitLab's password reset screen. Provide a secure password for the administrator's account: + + ![Create a password for the adminstrator's account.](gitlab-reset-password.png) + +1. You will be redirected to the login screen. Enter `root` as the username and the password you just created to log in. You can now begin creating GitLab repositories, users, and more. See [GitLab's official documentation](https://docs.gitlab.com/ee/university/training/topics/getting_started.html) for more information. + +### Add a Domain after Deploying your GitLab Instance + +If you configured your GitLab One-Click App without providing a domain, you can configure one after the app has been deployed. Begin by setting up DNS for your domain: + +1. Create an [*A record*](/docs/networking/dns/dns-records-an-introduction/#a-and-aaaa) associated with the IPv4 address for your Linode. Review the [DNS Manager](/docs/platform/manager/dns-manager/) guide for instructions on setting up DNS records. + +1. Wait for your new DNS records to [propagate to your internet service provider](/docs/platform/manager/dns-manager/#wait-for-propagation). + +After setting up DNS, you will need to update your GitLab instance's `/etc/gitlab/gitlab.rb` file with your domain name. This will ensure that any emails sent to users by the GitLab instance will use your site's domain. + +1. [Connect to your Linode via SSH](/docs/getting-started/#connect-to-your-linode-via-ssh). + +1. With a text editor of your choice ([nano](/docs/quick-answers/linux/use-nano-to-edit-files-in-linux/), for example), open the `/etc/gitlab/gitlab.rb` file and modify the value of `external_url`. Ensure you replace `http://example.com` with your domain: + + {{< file "/etc/gitlab/gitlab.rb" >}} +## GitLab URL +##! URL on which GitLab will be reachable. +##! For more details on configuring external_url see: +##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab +external_url 'http://example.com' +{{< /file >}} + +1. Issue the following command to enable your new configuration: + + gitlab-ctl reconfigure + +1. Navigate to the domain in a browser window and verify that you are directed to your GitLab instance. + +### Software Included + +The GitLab One-Click App will install the following required software on your Linode: + +| **Software** | **Description** | +|:--------------|:------------| +| [**GitLab**](https://about.gitlab.com/) | Remote Git repository software. | +| [**Postfix**](http://www.postfix.org/) | Postfix is a free and open-source mail transfer agent that routes and delivers electronic mail. | +| [**UFW**](https://wiki.ubuntu.com/UncomplicatedFirewall) | Firewall utility. Ports 22/tcp, 80/tcp, 443/tcp, 25, 587, and 110 for IPv4 and IPv6 will allow outgoing and incoming traffic. | +| [**Fail2ban**](https://www.fail2ban.org/wiki/index.php/Main_Page) | Fail2Ban is an intrusion prevention software framework that protects computer servers from brute-force attacks. | diff --git a/docs/platform/one-click/deploy-lamp-stack-with-one-click-apps/index.md b/docs/platform/one-click/deploy-lamp-stack-with-one-click-apps/index.md new file mode 100644 index 00000000000..3e4a28a4180 --- /dev/null +++ b/docs/platform/one-click/deploy-lamp-stack-with-one-click-apps/index.md @@ -0,0 +1,76 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Use One-Click Apps to deploy a LAMP stack on Linode' +keywords: ['LAMP', 'apache', 'web server', 'mysql', 'php'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-03-26 +modified: 2019-03-26 +modified_by: + name: Linode +title: "Deploy a LAMP Stack with One-Click Apps" +contributor: + name: Linode +external_resources: +- '[Apache Getting Started](http://httpd.apache.org/docs/current/getting-started.html)' +--- + +## LAMP Stack One-Click App + +A LAMP (Linux, [Apache](https://www.apache.org), [MySQL](https://www.mysql.com), [PHP](https://www.php.net)) stack is a popular, free, and open-source web software bundle used for hosting websites on Linux. This software environment is a foundation for popular PHP application frameworks like WordPress, Drupal, and Laravel. After you deploy your LAMP One-Click App, you can upload your existing PHP application code to it or use a PHP framework to write a new application on your Linode. + +### Deploy a LAMP Stack with One-Click Apps + +{{< content "deploy-one-click-apps" >}} + +The [LAMP Stack Options](#lamp-stack-options) section of this guide provides details on all available configuration options for this app. + +### LAMP Stack Options + +| **Field** | **Description** | +|:--------------|:------------| +| **MySQL Root Password** | The root password for your LAMP stack's MySQL database. This is not the same as your Linode's root password. *Required*. | + +### Linode Options + +After providing the app-specific options, enter configuration values for your Linode server: + +| **Configuration** | **Description** | +|:--------------|:------------| +| **Select an Image** | Debian 9 is currently the only image supported by the LAMP One-Click App, 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). The Linode plan you deploy your LAMP stack on should account for the estimated workload. If you are standing up a simple web page, you can use a Nanode or 2GB Linode. If you are standing up a larger or more robust web app, then consider a plan with higher RAM and CPU allocations. 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 LAMP Stack app will complete installation anywhere between 2-3 minutes after your Linode has finished provisioning.** + +### Getting Started After Deployment + +After your LAMP stack has finished deploying, you can: + +- [Connect to your Linode via SSH](/docs/getting-started/#connect-to-your-linode-via-ssh). You will need your Linode's root password to proceed. Note that your Linode's web root will be located in the `/var/www/html` directory. + +- [Navigate to the public IP address](/docs/getting-started/#find-your-linode-s-ip-address) of your Linode in a browser. You will see the PHP settings that are active for your Linode. + +- Consult the following guides to learn more about working with the various components of the LAMP stack: + + - [Secure HTTP Traffic with Certbot](https://linode.com/docs/quick-answers/websites/secure-http-traffic-certbot/) + - [Apache Configuration Basics](/docs/web-servers/apache-tips-and-tricks/apache-configuration-basics/) + - [How to Optimize MySQL Performance Using MySQLTuner](/docs/databases/mysql/how-to-optimize-mysql-performance-using-mysqltuner/) + +- Upload files to your web root directory with an SFTP application like [FileZilla](/docs/tools-reference/file-transfer/filezilla/). Use the same root credentials that you would use for SSH. + +- Assign a domain name to your Linode's IP address. Review the [DNS Manager](/docs/platform/manager/dns-manager/) guide for instructions on setting up your DNS records in the Cloud Manager, and read through [DNS Records: An Introduction](/docs/networking/dns/dns-records-an-introduction/) for general information about how DNS works. + +### Software Included + +The LAMP Stack One-Click App will install the following software on your Linode: + +| **Software** | **Description** | +|:--------------|:------------| +| [**Apache HTTP Server**](https://www.apache.org) | Web server that can be used to serve your site or web application.| +| [**MySQL Server**](https://www.mysql.com) | Relational database. | +| [**PHP 7**](https://www.php.net) | General purpose programming language. | +| [**UFW (Uncomplicated Firewall)**](https://en.wikipedia.org/wiki/Uncomplicated_Firewall) | Firewall utility. Ports 22/tcp, 80/tcp, and 443/tcp for IPv4 and IPv6 will allow outgoing and incoming traffic. | \ No newline at end of file diff --git a/docs/platform/one-click/deploy-mern-with-one-click-apps/index.md b/docs/platform/one-click/deploy-mern-with-one-click-apps/index.md new file mode 100644 index 00000000000..2be64d58c52 --- /dev/null +++ b/docs/platform/one-click/deploy-mern-with-one-click-apps/index.md @@ -0,0 +1,79 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Deploy the MERN stack on Linode with One-Click Apps.' +keywords: ['mongodb','mern','react','express', 'web app'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-04-02 +modified: 2019-04-02 +modified_by: + name: Linode +title: "Deploy MERN with One-Click Apps" +contributor: + name: Linode +external_resources: +- '[MongoDB Getting Started](https://docs.mongodb.com/manual/tutorial/getting-started/)' +- '[Express Hello World Example](https://expressjs.com/en/starter/hello-world.html)' +- '[React Getting Started](https://reactjs.org/docs/getting-started.html)' +- '[Node.js Getting Started](https://nodejs.org/es/docs/guides/getting-started-guide/)' +--- + +## MERN One-Click App + +A MERN (MongoDB, Express, React, Node.js) stack is a free and open-source web software bundle used to build modern web applications: + +- [MongoDB](https://www.mongodb.com/) is a document database used to persist your application's data. + +- [Express](https://expressjs.com/) serves as the web application framework. + +- [React](https://reactjs.org/) is used to build your application's user interfaces using JavaScript. React offers a server-side rendering function which makes it easier for search engines to crawl your web application. + +- [Node.js](https://nodejs.org/en/about/) serves as the run-time environment for your application. + +All of these technologies are well-established, offer robust feature sets, and are well-supported by their maintaining organizations. These characteristics make them a great choice for your applications. Upload your existing MERN website code to your new Linode, or use MERN's scaffolding tool to start writing new web applications on the Linode. + +### Deploy a MERN One-Click App + +{{< content deploy-one-click-apps>}} + +### MERN Options + +| **Field** | **Description** | +|:--------------|:------------| +| **MongoDB Admin Password** | The administrative password for your MongoDB database. *Required*. | + +### Linode Options + +| **Configuration** | **Description** | +|:--------------|:------------| +| **Select an Image** | Debian 9 is currently the only image supported by the MERN One-Click App, 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). The Linode plan you deploy your MERN stack on should account for the estimated workload. If you are standing up a simple web page, you can use a Nanode or 2GB Linode. If you will deploy a more robust web app, then consider a plan with higher RAM and CPU allocations. 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*. | + + +### Getting Started After Deployment + +After your MERN One-click App has finished installing, you can: + +- [Connect to your Linode via SSH](/docs/getting-started/#connect-to-your-linode-via-ssh). You will need your Linode's root password to proceed. + +- Install the [MERN CLI](http://mern.io/documentation.html) (command line interface) a utility that provides code generation and scaffolding capabilities. + +- Consult the following guides to learn more about working with the various components of the MERN stack: + + - [Build Database Clusters with MongoDB](/docs/databases/mongodb/build-database-clusters-with-mongodb/) + - [Deploy a React Application on Linode](/docs/development/javascript/deploy-a-react-app-on-linode/) + + +### Software Included + +| **Software** | **Description** | +|:--------------|:------------| +| **MongoDB** | Document-based database | +| **Express** | Web application framework | +| **React** | JavaScript library | +| **Node JS** | Runtime environment | +| **UFW (UncomplicatedFirewall)** | Firewall utility. Ports 22/tcp for IPv4 and IPv6 will allow incoming traffic. All other ports will have the following firewall rules: deny (incoming), allow (outgoing). | \ No newline at end of file diff --git a/docs/platform/one-click/deploy-one-click-apps/index.md b/docs/platform/one-click/deploy-one-click-apps/index.md new file mode 100644 index 00000000000..480bb7507c1 --- /dev/null +++ b/docs/platform/one-click/deploy-one-click-apps/index.md @@ -0,0 +1,33 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Shortguide for deploying One-Click Apps' +keywords: ['one-click', 'apps'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-03-26 +modified: 2019-03-26 +modified_by: + name: Linode +title: "Index" +contributor: + name: Linode +headless: true +show_on_rss_feed: false +--- + + + +One-Click Apps allow you to easily deploy software on a Linode using the Linode Cloud Manager. To access Linode's One-Click Apps: + +1. Log in to your [Linode Cloud Manager](https://cloud.linode.com) account. + +1. From the Linode dashboard, click on the **Create** button in the top left-hand side of the screen and select **Linode** from the dropdown menu. + +1. The Linode creation page will appear. Select the **One-Click** tab. + +1. Under the **Select App** section, select the app you would like to deploy: + + {{< image src="one-click-apps-create.png" alt="Select a One-Click App to deploy" title="Select a One-Click App to deploy" >}} + +1. Once you have selected the app, proceed to the app's **Options** section and provide values for the required fields. \ No newline at end of file diff --git a/docs/platform/one-click/deploy-one-click-apps/one-click-apps-create.png b/docs/platform/one-click/deploy-one-click-apps/one-click-apps-create.png new file mode 100644 index 00000000000..dd8a47847b7 Binary files /dev/null and b/docs/platform/one-click/deploy-one-click-apps/one-click-apps-create.png differ diff --git a/docs/platform/one-click/deploy-wireguard-with-one-click-apps/index.md b/docs/platform/one-click/deploy-wireguard-with-one-click-apps/index.md new file mode 100644 index 00000000000..cc04e584e4e --- /dev/null +++ b/docs/platform/one-click/deploy-wireguard-with-one-click-apps/index.md @@ -0,0 +1,164 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Deploy a WireGuard Server on Linode with One-Click Apps.' +keywords: ['vpn','wireguard','tunnel'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-03-28 +modified_by: + name: Linode +title: "Deploy WireGuard with One-Click Apps" +contributor: + name: Linode +external_resources: +- '[WireGuard Quick Start](https://www.wireguard.com/quickstart/)' +- '[WireGuard Conceptual Overview](https://www.wireguard.com/#conceptual-overview)' +- '[WireGuard man page](https://manpages.debian.org/unstable/wireguard-tools/wg.8.en.html)' +--- + +## WireGuard One-Click App + +WireGuard is a simple, fast, and modern virtual private network (VPN) which utilizes state-of-the-art cryptography. It aims to be faster and leaner than other VPN protocols such as OpenVPN and IPSec, and it has a much smaller source code footprint. + +Configuring WireGuard is as simple as configuring SSH. A connection is established by an exchange of public keys between server and client, and only a client whose public key is present in the server's configuration file is considered authorized. WireGuard sets up standard network interfaces which behave similarly to other common network interfaces, like `eth0`. This makes it possible to configure and manage WireGuard interfaces using standard networking tools such as ifconfig and ip. + +The WireGuard One-Click App will create a Linode instance and set up a WireGuard network device named `wg0` on it. This device will have a simple configuration which can send and receive traffic to/from a single WireGuard peer (which will also be referred to as your WireGuard *client*). + +{{< note >}} +The peer configurations provided by the One-Click App and this guide will allow you to directly connect your WireGuard server and client. This configuration will *not* enable forwarding of all of your client's traffic through the WireGuard server to the public Internet (though that arrangement is possible with WireGuard). + +Your WireGuard configuration can be adjusted after you first set up your One-Click App; review the [WireGuard man page](https://manpages.debian.org/unstable/wireguard-tools/wg.8.en.html) for more information about the options that are available. +{{< /note >}} + +## Deploy WireGuard with One-Click Apps + +{{< content deploy-one-click-apps >}} + +### WireGuard Options + +The WireGuard One-Click form includes fields for your WireGuard client's [*public key*](https://www.wireguard.com/quickstart/#key-generation), and for your client's *endpoint IP* (which is your client's public IP address). If you have already set up your client and installed the WireGuard software on it prior to setting up your WireGuard One-Click App, then you may already have this information. If you do have the key and the endpoint IP for the client, you can enter them into the app's creation form, and your server's configuration will be pre-populated with those values. + +{{< note >}} +Please note that a public key generated by WireGuard will not resemble [a public key that you might use for SSH connections](/docs/security/authentication/use-public-key-authentication-with-ssh/); when in doubt, leave the form's **Public Key (Client)** field blank. +{{< /note >}} + +If you do not have the values for these fields, you can leave them empty. After the app is deployed, visit the [Configure and Connect your WireGuard Client and Server](#configure-and-connect-your-wireguard-client-and-server) section to set up your client and generate a key. The instructions in that section will also show you how to insert the key and the endpoint IP for your client into your server's configuration. + +| **Field**                                  | **Description** | +|-----------|-----------------| +| **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*. | +| **Port** | Set your WireGuard server's listening port number. The default is: `51820`. *Advanced Configuration*. | +| **Tunnel IP** | Your WireGuard server's tunnel IP address and subnet in CIDR notation. The default is: `10.0.1.1/24`. This is not the same as a private IP address that Linode can assign to your Linode instance; instead, this address is managed by the network that WireGuard creates. *Advanced Configuration*. | +| **WireGuard Public Key (Client)** | Your WireGuard client's public key. *Advanced Configuration*. | +| **Tunnel IP (Client)** | Your WireGuard client's tunnel IP address and subnet in CIDR notation. The default is: `10.0.1.2/24`. This is not the same as a private IP address that Linode can assign to your Linode instance; instead, this address is managed by the network that WireGuard creates. *Advanced Configuration*. | +| **Endpoint IP (Client)** | The Internet address of your WireGuard client. If your WireGuard client is another Linode, then the Endpoint IP is the public IP of that Linode, which is visible in the Linode's dashboard in the Linode Cloud Manager. *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 the WireGuard One-Click App, 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). You can use any size Linode for your WireGuard App. The Linode plan that you select should be appropriate for the amount of data transfer, users, and other stress that may affect the performance of your VPN. You can create your VPN on a Nanode 1GB or a Linode 2GB with low risk for performance hits, unless you expect intensive data transfer to happen on your VPN. *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 WireGuard app will complete installation anywhere between 2-5 minutes after your Linode has finished provisioning**. + +## Getting Started after Deployment + +### Configure and Connect your WireGuard Client and Server + +After your One-Click App has provisioned your WireGuard server, you can proceed with setting up your WireGuard client and establishing a connection to the server. + +If you did not provide a public key for WireGuard when you first set up your One-Click App, you will need to follow the next set of steps. These instructions will set up your client and inform your server of your client's public key. If you did provide a public key when deploying the One-Click App and have set up your client, skip to the second collection of steps in this section. + +1. Follow the [WireGuard Client](/docs/networking/vpn/set-up-wireguard-vpn-on-ubuntu/#wireguard-client) section of our WireGuard guide to generate a public/private keypair for your client, and to set up the WireGuard network interface configuration on your client. + +1. [Connect to your One-Click App's Linode via SSH](/docs/getting-started/#connect-to-your-linode-via-ssh). + +1. Bring down the `wg0` interface on the server: + + wg-quick down wg0 + +1. Open the `/etc/wireguard/wg0.conf` file in a text editor ([nano](/docs/quick-answers/linux/use-nano-to-edit-files-in-linux/), for example). + +1. You will see a line that reads `PublicKey = ` under the `[Peer]` section. Append your client's public key to this line. + +1. You will also see a line that reads `Endpoint = `. Append your client's Internet address to this line and then save the file. If your WireGuard client is also a Linode, user your Linode's public IP. If your client is on your home computer, visit a site like [whatismyip.com](https://www.whatismyip.com) to get your address. + +1. Bring the `wg0` interface back up on the server: + + wg-quick up wg0 + + {{< note >}} +`wg-quick` is a convenient wrapper for many of the common functions in `wg`. To learn more about all the available commands for each utility, issue the `wg --help` and `wg-quick --help` commands from your Linode's command line. +{{}} + +You should now have your server configuration completed. At this point, you still need to complete your client's configuration; specifically, you need to add your server as a peer to the client: + +1. [Connect to your One-Click App's Linode via SSH](/docs/getting-started/#connect-to-your-linode-via-ssh). + +1. Just like your client, your server also has a public/private keypair of its own. The One-Click App script leaves a copy of these keys in the root user's home folder: + + ls /root + + {{< output >}} +wg-private.key wg-public.key +{{< /output >}} + +1. Use the `cat` command to get the value of the server's WireGuard public key: + + cat /root/wg-public.key + +1. You should see a random string similar to: + + {{< output >}} +FngGVypEJ13KU8+OeBGG1sOd2i+aazsj7qPL3ZxacG8= +{{< /output >}} + +1. Copy the output of your server's public key, then use it to complete **steps 1 and 2** of the [Connect the Client and Server](/docs/networking/vpn/set-up-wireguard-vpn-on-ubuntu/#connect-the-client-and-server) section of our WireGuard guide. These steps will tell you to append `[Peer]` section to your client's existing WireGuard configuration and then how to enable the service on your client. + + Enter your server's WireGuard tunnel IP (using the `/24` CIDR notation) as the value for the `AllowedIPs` setting, and set the server's public IP address and WireGuard port to be the Endpoint. Here's an example template for a completed client configuration: + + {{< file >}} +[Interface] +PrivateKey = +Address = 10.0.1.2 + +[Peer] +PublicKey = +AllowedIPs = 10.0.1.1 +Endpoint = :51820 +{{< /file >}} + + After you complete steps 1 and 2 from that section, you will have established the server as the client's peer. + +### Test your WireGuard Client's Connection + +This test should be performed once you have configured a WireGuard client and updated your WireGuard server to include the client's peer information: + +1. Access your WireGuard client and ping the WireGuard server. Replace `10.0.1.1` with the tunnel IP address you assigned to the WireGuard server in the One-Click App creation form: + + ping 10.0.1.1 + +1. Use the WireGuard utility to verify your client's latest handshake: + + wg show + + The last two lines of the output from running the wg command should be similar to: + + {{< output >}} +latest handshake: 1 minute, 17 seconds ago +transfer: 98.86 KiB received, 43.08 KiB sent +{{}} + +### Software Included + +| **Software** | **Description** | +|--------------|-----------------| +| [**WireGuard**](https://www.wireguard.com) | VPN software. | +| [**UFW (UncomplicatedFireWall)**](https://wiki.ubuntu.com/UncomplicatedFirewall) | Firewall utility. The Port assigned during the [WireGuard Options](#wireguard-options) step of the deployment will allow outgoing and incoming traffic. | diff --git a/docs/platform/one-click/deploying-ark-survival-evolved-with-one-click-apps/ark-one-click-add-server.png b/docs/platform/one-click/deploying-ark-survival-evolved-with-one-click-apps/ark-one-click-add-server.png new file mode 100644 index 00000000000..964915d68ec Binary files /dev/null and b/docs/platform/one-click/deploying-ark-survival-evolved-with-one-click-apps/ark-one-click-add-server.png differ diff --git a/docs/platform/one-click/deploying-ark-survival-evolved-with-one-click-apps/ark-one-click-session-filter.png b/docs/platform/one-click/deploying-ark-survival-evolved-with-one-click-apps/ark-one-click-session-filter.png new file mode 100644 index 00000000000..2e610a34143 Binary files /dev/null and b/docs/platform/one-click/deploying-ark-survival-evolved-with-one-click-apps/ark-one-click-session-filter.png differ diff --git a/docs/platform/one-click/deploying-ark-survival-evolved-with-one-click-apps/ark-one-click-steam-favorite-servers.png b/docs/platform/one-click/deploying-ark-survival-evolved-with-one-click-apps/ark-one-click-steam-favorite-servers.png new file mode 100644 index 00000000000..75c620f9d00 Binary files /dev/null and b/docs/platform/one-click/deploying-ark-survival-evolved-with-one-click-apps/ark-one-click-steam-favorite-servers.png differ diff --git a/docs/platform/one-click/deploying-ark-survival-evolved-with-one-click-apps/index.md b/docs/platform/one-click/deploying-ark-survival-evolved-with-one-click-apps/index.md new file mode 100644 index 00000000000..10d318a24f8 --- /dev/null +++ b/docs/platform/one-click/deploying-ark-survival-evolved-with-one-click-apps/index.md @@ -0,0 +1,97 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Deploy a ARK: Survival Evolved Server on Linode using One-Click Apps.' +keywords: ['ark','survival evolved','one-click apps', 'server'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-04-03 +modified: 2019-03-03 +modified_by: + name: Linode +title: "Deploy an ARK: Survival Evolved Server with One-Click Apps" +contributor: + name: Linode +external_resources: + - '[The Official ARK: Survival Evolved Wiki](https://ark.gamepedia.com/ARK_Survival_Evolved_Wiki)' +--- + +## Ark: Survival Evolved One-Click App + +ARK: Survival Evolved is a multiplayer action-survival game released in 2017. The game places you on a series of fictional islands inhabited by dinosaurs and other prehistoric animals. In ARK, the main objective is to survive. ARK is an ongoing battle where animals and other players have the ability to destroy you. To survive, you must build structures, farm resources, breed dinosaurs, and even set up trading hubs with neighboring tribes. + +Hosting an ARK server gives you control of the entire game. You can define the leveling speed, the amount of players, and the types of weapons that are available. + +### Deploy an ARK: Survival Evolved One-Click App + +{{< content "deploy-one-click-apps">}} + +The [ARK Options](#ark-options) section of this guide provides details on all available configuration options for this app. + +### ARK Options + +You can configure your ARK One-Click App by providing values for the following fields: + +| **Field**                                  | **Description** | +|-----------|-----------------| +| **RCON Password** | Your password for [RCON](https://developer.valvesoftware.com/wiki/Source_RCON_Protocol), a protocol which allows ARK administrators to remotely execute commands on the game server. *Required*. | +| **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*. | +| **Server Name** | Your ARK server's name. *Advanced Configuration*. | +| **Message of the Day** | A message that is displayed whenever a player logs on to the server. *Advanced Configuration*. | +| **Server Password** | Your ARK server's password, if you want the game server to be password protected. *Advanced Configuration*. | +| **Hardcore Mode Enabled** | Enables Hardcore mode, which resets a player to level 1 after dying. *Advanced Configuration*. | +| **XP Multiplier** | Increases or decreases the amount of experience awarded for various actions. *Advanced Configuration*. | +| **Server PvE** | Disables player vs player combat and enables player vs environment combat. *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 ARK: Survival Evolved 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). Your ARK server should be sized based on the amount of traffic you are expecting on your server as well as the game play performance you are looking for. We recommend using a 8GB Linode as the smallest plan to ensure good performance of your game server. A 8GB Dedicated plan will provide better game performance as well. 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. **ARK should install between 5-15 minutes after your Linode has successfully provisioned**. + +## Getting Started After Deployment + +Ensure that you have [installed Steam](https://store.steampowered.com/about/) on your personal computer and bought the ARK: Survival Evolved game on your Steam account before getting started with this section. + +After the Ark: Survival Evolved Server One-Click App has finished installing, you will be able to access your server by copying your Linode's IPv4 address and entering it into the favorite servers list in your computer's Steam client: + +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. Copy the address. + +1. On your personal computer, open Steam. Click on **View > Servers**, then click on the **Favorites** tab. + + ![The Steam favorite servers dialog box.](ark-one-click-steam-favorite-servers.png) + +1. Click on **Add a Server**, then paste in your Linode's IP address. Click on **Add This Address to Favorites**. + + ![Add your server to your list of favorite servers.](ark-one-click-add-server.png) + +1. Once you have added your Linode's IP address to your Steam favorites list, open ARK: Survival Evolved. Click on **Join ARK**. At the bottom of the screen, click on the **Session Filter** drop down list and select **Favorites**. Your ARK Linode should appear: + + ![ARK server list containing the Linode that was added to Steam favorites.](ark-one-click-session-filter.png) + + Click on the server and then select **Join** at the bottom of the screen. You will be loaded into your server. + +### Software Included + +The ARK: Survival Evolved One-Click App will install the following required software on your Linode: + +| **Software** | **Description** | +|:--------------|:------------| +| [**ARK: Survival Evolved**](https://store.steampowered.com/app/346110/ARK_Survival_Evolved/) | Game server. | +| [**LinuxGSM**](https://linuxgsm.com) | A command line tool for the deployment and management of Linux game servers. | +| [**UFW**](https://wiki.ubuntu.com/UncomplicatedFirewall) | Firewall utility. Ports 27015/udp, 7777:7778/udp and 27020/tcp will allow outgoing and incoming traffic. | +| [**Fail2ban**](https://www.fail2ban.org/wiki/index.php/Main_Page) | Fail2Ban is an intrusion prevention software framework that protects computer servers from brute-force attacks. | \ No newline at end of file diff --git a/docs/platform/one-click/deploying-cs-go-with-one-click-apps/cs-go-developers-console.png b/docs/platform/one-click/deploying-cs-go-with-one-click-apps/cs-go-developers-console.png new file mode 100644 index 00000000000..0f61e4783d5 Binary files /dev/null and b/docs/platform/one-click/deploying-cs-go-with-one-click-apps/cs-go-developers-console.png differ diff --git a/docs/platform/one-click/deploying-cs-go-with-one-click-apps/cs-go-enable-developer-console.png b/docs/platform/one-click/deploying-cs-go-with-one-click-apps/cs-go-enable-developer-console.png new file mode 100644 index 00000000000..643d06e3210 Binary files /dev/null and b/docs/platform/one-click/deploying-cs-go-with-one-click-apps/cs-go-enable-developer-console.png differ diff --git a/docs/platform/one-click/deploying-cs-go-with-one-click-apps/index.md b/docs/platform/one-click/deploying-cs-go-with-one-click-apps/index.md new file mode 100644 index 00000000000..b98f63d7e9b --- /dev/null +++ b/docs/platform/one-click/deploying-cs-go-with-one-click-apps/index.md @@ -0,0 +1,95 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Deploy a Counter-Strike: Global Offensive server on Linode using One-Click Apps.' +keywords: ['counter-strike','cs', 'go','one-click'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-03-28 +modified: 2019-03-28 +modified_by: + name: Linode +title: "Deploy Counter-Strike: Global Offensive with One-Click Apps" +contributor: + name: Linode +external_resources: +- '[List of CS:GO Cvar Commands to use with RCON](https://developer.valvesoftware.com/wiki/List_of_CS:GO_Cvars)' +--- + +## Counter-Strike: Global Offensive One-Click App + +Counter-Strike: Global Offensive (CS:GO) is a fast-paced first person shooter. Teams compete against each other to complete objectives or to eliminate the opposing team. + +A competitive match requires two teams of five players, but hosting your own server offers you control over team size and server location, so you and your friends can play with low latency. Up to 64 players can be hosted on a single server. + +### Deploy a CS:GO One-Click App + +{{< content "deploy-one-click-apps">}} + +The [CS:GO Options](#cs-go-options) section of this guide provides details on all available configuration options for this app. + +### CS:GO Options + +You can configure your CS:GO App by providing values for the following fields: + +| **Field**                         | **Description** | +|:--------------|:------------| +| **Game Server Login Token** | A Steam game server login token. This is required to publicly list your server. To get a Steam Token, visit the [Steam Game Server Account Management](https://steamcommunity.com/dev/managegameservers) page. *Required*. | +| **RCON Password** | Password for [RCON](https://developer.valvesoftware.com/wiki/Source_RCON_Protocol), a protocol which allows CS:GO administrators to remotely execute commands on the game server. Password must be at least 6 characters and contain each of the following characters: uppercase, lowercase, numeric, and special character. *Required*. | +| **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*. | +| **Server Name** | Your CS:GO server's name. *Advanced Configuration*. | +| **Message of the Day** | The message of the day text that is displayed whenever a player logs on to the server. *Advanced Configuration*. | +| **CS:GO Server Password** | The password for the CS:GO server, if you want to make it password protected. Password must be at least 6 characters and contain each of the following characters: uppercase, lowercase, numeric, and special character. *Advanced Configuration*. | +| **Team Balance Enabled** | When enabled, automatically balances the number of players on a team. *Advanced Configuration*. | +| **Round Time Limit** | The time per round, in minutes. *Advanced Configuration*. | +| **Maximum Rounds** | The maximum amount of rounds before the map changes. *Advanced Configuration*. | +| **Buy Anywhere** | When enabled, allows teams to buy equipment from outside buy zones. *Advanced Configuration*. | +| **Friendly Fire Enabled** | Friendly fire allows teammates to damage and kill each other. *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 the CS:GO One-Click App, 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). Your CS:GO server should be sized based on the amount of traffic you are expecting on your server. Higher-tier plans may also provide better network game performance than lower-tier plans. We recommend using a 4GB Linode as the minimum plan for CS:GO servers. 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** | Create a root password for your Linode in the Root Password field. 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. *Required*. | + +When you've provided all required Linode Options, click on the **Create** button. **CS:GO should complete its installation between 5-15 minutes after your Linode has successfully provisioned**. + +## Getting Started after Deployment + +After CS:GO has finished installing, you will be able to access your game server by connecting to its IP address. 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 the IPv4 address. + +1. In CS:GO, use the back tick key (**`**) to open the developer's console. Type `connect 192.0.2.240` and click **Submit**, where `192.0.2.240` is the IP address of your Linode: + + ![The CS:GO developer's console.](cs-go-developers-console.png) + +1. If pressing the back tick key does not bring up the developer's console, you might need to enable it in the settings. Under *Game Settings* choose **Enable Developer's Console** and select **Yes**: + + ![Enable the developer's console if it is not currently enabled.](cs-go-enable-developer-console.png) + +### Software Included + +The CS:GO One-Click App will install the following required software on your Linode: + +| **Software** | **Description** | +|--------------|-----------------| +| [**Counter-Strike: Global Offensive**](https://store.steampowered.com/app/730/CounterStrike_Global_Offensive/) | Game server. | +| [**LinuxGSM**](https://linuxgsm.com) | A command line tool for the deployment and management of Linux game servers. | +| [**UFW**](https://wiki.ubuntu.com/UncomplicatedFirewall) | Firewall utility. Ports 27015, 27020/udp, 27005/udp, will allow outgoing and incoming traffic. | +| [**Fail2ban**](https://www.fail2ban.org/wiki/index.php/Main_Page) | Fail2Ban is an intrusion prevention software framework that protects computer servers from brute-force attacks. | diff --git a/docs/platform/one-click/deploying-drupal-with-one-click-apps/drupal-log-in.png b/docs/platform/one-click/deploying-drupal-with-one-click-apps/drupal-log-in.png new file mode 100644 index 00000000000..1281753030d Binary files /dev/null and b/docs/platform/one-click/deploying-drupal-with-one-click-apps/drupal-log-in.png differ diff --git a/docs/platform/one-click/deploying-drupal-with-one-click-apps/index.md b/docs/platform/one-click/deploying-drupal-with-one-click-apps/index.md new file mode 100644 index 00000000000..021fba6e6be --- /dev/null +++ b/docs/platform/one-click/deploying-drupal-with-one-click-apps/index.md @@ -0,0 +1,100 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Deploy a Drupal website on Linode using One-Click Apps.' +keywords: ['drupal','one-click', 'cms'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-03-25 +modified: 2019-03-25 +modified_by: + name: Linode +title: "Deploy Drupal with One-Click Apps" +contributor: + name: Linode +external_resources: + - '[Drupal 8 Official Documentation](https://www.drupal.org/docs/8)' + - '[Getting Started with Drupal 8 Administration](https://www.drupal.org/docs/8/administering-a-drupal-8-site/getting-started-with-drupal-8-administration)' +--- + +## Drupal One-Click App + +Drupal is a content management system (CMS) designed for building custom websites for personal and business use. Built for high performance and scalability, Drupal provides the necessary tools to create rich, interactive "community" websites with forums, user blogs, and private messaging. Drupal also has support for personal publishing projects and can power podcasts, blogs, and knowledge-based systems, all within a single, unified platform. + +In addition to the core infrastructure, there are a number of freely available Drupal modules that allow administrators of Drupal sites to provide additional functionality, and a robust API makes it easy to enable these features. Furthermore, Drupal has an advanced theming engine that allows for a great amount of flexibility for displaying content. + +### Deploy a Drupal One-Click App + +{{< content "deploy-one-click-apps">}} + +The [Drupal Options](#drupal-options) section of this guide provides details on all available configuration options for this app. + +### Drupal Options + +You can configure your Drupal App by providing values for the following fields: + +| **Field** | **Description** | +|:--------------|:------------| +| **Drupal admin password** | Password for your Drupal admin profile. *Required*. | +| **Drupal admin username** | Username for your Drupal admin user. *Required*. | +| **E-Mail for your Drupal account** | E-Mail address for your Drupal admin user. *Required*. | +| **Your SSH public key** | Your SSH public key. *Advanced Configuration*. | +| **Domain** | Domain for your Drupal site. Setting a value in this field will not also enable DNS for your app, which you should do as well. Read our [DNS Manager](/docs/platform/manager/dns-manager/) guide for instructions on creating DNS records in the Linode Cloud Manager. *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 Drupal 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). Drupal is an extremely flexible CMS that can be supported on any size Linode, but we suggest you deploy your Drupal app on a Linode plan that reflects how much content you plan on featuring as well as how much traffic you expect for 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 Drupal app will complete installation anywhere between 2-5 minutes after your Linode has finished provisioning**. + +## Getting Started after Deployment + +### Access your Drupal Site + +After Drupal has finished installing, you will be able to access your Drupal site over `http://` with your Linode's IPv4 address, or the domain name entered when deploying your One-Click App: + +1. Access your Drupal site: + + **With your Linode's IP Address** + + You will be able to access your Drupal 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. The IP address will be displayed under the **Address** column in the **IPv4** table. + + 1. Copy and paste the IPv4 address into a browser window. You should see the Drupal welcome page appear. + + **With a Domain Name** + + If you deployed your Drupal One-Click App with a domain name and it is pointing to the Linode's IP address that is hosting your Drupal instance, then you can enter the domain name in a browser window to access your Drupal site. Ensure you are using `http://`. + + For more details on registering your domain, see the [DNS Manager](/docs/platform/manager/dns-manager/) guide. + +1. Once you have accessed your Drupal site via the browser, you can log in using the admin credentials you created when deploying your app. Then, begin configuring your site. + + ![Log in to your Drupal site.](drupal-log-in.png) + +### Software Included + +The Drupal 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) | Drupal is written in PHP and requires PHP to operate. | +| [**Apache HTTP Server**](https://httpd.apache.org) | Web Server used to serve the Drupal site. | +| [**Drush**](https://www.drush.org) | A command line shell for Drupal. | +| [**Drupal 8**](https://www.drupal.org/8) | Content management system. | \ No newline at end of file diff --git a/docs/platform/one-click/deploying-drupal-with-one-click-apps/one-click-apps-create.png b/docs/platform/one-click/deploying-drupal-with-one-click-apps/one-click-apps-create.png new file mode 100644 index 00000000000..dd8a47847b7 Binary files /dev/null and b/docs/platform/one-click/deploying-drupal-with-one-click-apps/one-click-apps-create.png differ diff --git a/docs/platform/one-click/deploying-minecraft-with-one-click-apps/index.md b/docs/platform/one-click/deploying-minecraft-with-one-click-apps/index.md new file mode 100644 index 00000000000..697fc0bf02a --- /dev/null +++ b/docs/platform/one-click/deploying-minecraft-with-one-click-apps/index.md @@ -0,0 +1,121 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Deploy a Minecraft server on Linode using One-Click Apps.' +keywords: ['minecraft','one-click', 'server'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-04-01 +modified: 2019-04-01 +modified_by: + name: Linode +title: "Deploy a Minecraft Server with One-Click Apps" +contributor: + name: Linode +external_resources: +- '[Minecraft Wiki](https://minecraft.gamepedia.com/Minecraft_Wiki)' +--- + +## Minecraft One-Click App + +With over 100 million users around the world, [Minecraft](https://www.minecraft.net/en-us/) is the most popular online game of all time. You and other players are free to build and explore in a 3D generated world made up of millions of mineable blocks. Collect resources by leveling mountains, taming forests, and venturing out to sea. Choose a home from the varied list of biomes like ice worlds, flower plains, and jungles. Build ancient castles or modern mega cities, and fill them with redstone circuit contraptions and villagers. Fight off nightly invasions of Skeletons, Zombies, and explosive Creepers, or adventure to the End and the Nether to summon the fabled End Dragon and the chaotic Wither. If that is not enough, Minecraft is also highly moddable and customizable. You decide the rules when hosting your own Minecraft server for you and your friends to play together in this highly addictive game. + +### Deploy a Minecraft Server One-Click App + +{{< content "deploy-one-click-apps">}} + +The [Minecraft Options](#minecraft-options) section of this guide provides details on all available configuration options for this app. + +### Minecraft Options + +You can configure your Minecraft Server App by providing values for the following fields: + +| **Field**           | **Description** | +|:--------------|:------------| +| **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*. | +| **World Name** | The world name and it's corresponding file name. *Advanced Configuration*. | +| **Message of the Day** | Text that is displayed whenever a player logs on to the server. *Advanced Configuration*. | +| **Flight Enabled** | Allows flight if there is a mod installed that supports flying. This configuration has no effect on creative mode flight. *Advanced Configuration*. | +| **Nether World Enabled** | Enables the Nether world. *Advanced Configuration*. | +| **Player Achievements Enabled** | Whenever a player unlocks an achievement, it is broadcast to all logged in players. *Advanced Configuration*. | +| **Maximum Players** | Maximum amount of players allowed on the server. *Advanced Configuration*. | +| **Player Idle Timeout Limit** | If not set to *disabled*, the amount of time in minutes a player can be idle before being kicked off of the server. *Advanced Configuration*. | +| **Difficulty Level** | The game difficulty. *Advanced Configuration*. | +| **Hardcore Mode Enabled** | If set to `true`, the difficulty will be set to *Hard*. Additionally, on death the player won't respawn and will be limited to *spectator* mode. *Advanced Configuration*. | +| **PvP Enabled** | Enables player versus player combat on the server. *Advanced Configuration*. | +| **Force Game Mode Enabled** | Forces players to join the server's default game mode. `false` allows players to join with their previous game mode. `true` forces the default game mode. +| **World Type** | Type of world to generate. *Default* = standard, *flat* = featureless and flat, *largebiomes* = larger biomes, *amplified* = larger height limit. *Advanced Configuration*. | +| **World Seed** | A random value used by Minecraft's world generation algorithm to create a unique world. For example: `qazwsx123`. See [Minecraft's Gamepedia](https://minecraft.gamepedia.com/Seed_(level_generation)) entry on seeds for more information. *Advanced Configuration*. | +| **Spawn Animals Enabled** | Determines if animals (sheep, chickens, squid, etc.) will spawn. *Advanced Configuration*. | +| **Spawn Monsters Enabled** | Determines if monsters (creepers, skeletons, spiders, etc.) will spawn. *Advanced Configuration*. | +| **Spawn NPCs Enabled** | Determines if villagers will spawn. *Advanced Configuration*. | +| **Game Mode** | The game mode of the server. *Survival* is the default game mode, *creative* allows for flight and unlimited resources, *adventure* prevents players from destroying blocks, and *spectator* will grant the ability to fly, but will prevent any player interaction on the server. *Advanced Configuration*. | +| **Structure Generation Enabled** | Enables the ability to generate structures like villages and mineshafts. *Advanced Configuration*. | +| **Maximum Build Height** | Maximum height at which players can place blocks. World generation may exceed this limit. *Advanced Configuration*. | +| **Maximum World Size** | Maximum radius of the world, in blocks. *Advanced Configuration*. | +| **View Distance** | The distance a player can see, measured in chunks (16 block cubes). For example, `10` will enable the user to see 10 chunks in any direction. | +| **Command Block Enabled** | Enables the placement of command blocks through the `/give` command. *Advanced Configuration*. | +| **Querying Enabled** | Enables GameSpy4. Used to obtain information about the server. *Advanced Configuration*. | +| **Enable RCON** | Enable remote access (RCON) to the Minecraft server to run commands. *Advanced Configuration*. | +| **RCON Password** | The RCON password. *Advanced Configuration*. | +| **RCON Port** | The port used for RCON. *Advanced Configuration*. | +| **Maximum Tick Time** | The maximum amount of milliseconds a single tick can take before the server considers itself frozen or crashed and will shut down. *Advanced Configuration*. | +| **Network Compression Threshold** | The threshold at which bytes are compressed. *Advanced Configuration*. | +| **Op-permission Level** | Sets the permission level for operators (ops) when using the `/op` command. *Advanced Configuration*. | +| **Port Number** | The server's listening port number. *Advanced Configuration*. | +| **Snooper Enabled** | Determines if the server sends stats to [https://snoop.minecraft.net](https://snoop.minecraft.net). *Advanced Configuration*. | +| **Use Native Transport Enabled** | Improve server performance by optimizing sent and received packets. *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 Minecraft 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). Your MineCraft App should be sized based on the amount of traffic you expect to see on your server. We recommend 1GB of RAM for every 15 players maximum on your server. For example, If you are expecting a small group of players (between 1-15), you should be okay with a Nanode. Up to 30 players, a 2GB Linode, and so on. *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. **MineCraft should install between 5-10 minutes after your Linode has successfully provisioned**. + +## Getting Started after Deployment + +Ensure that you have [installed Minecraft](https://my.minecraft.net/store/minecraft/) on your personal computer and created a Minecraft user account before getting started with this section. + +After Minecraft has finished installing on your Linode, you will be able to access your Minecraft server by copying your Linode's IPv4 address and entering it in the Multiplayer menu on your personal computer's Minecraft installation. 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. Under the **IPv4** heading, you will find your IPv4 address listed under the **Address** column. Copy your IPv4 address. + +1. Open Minecraft on your computer and click on **Multiplayer**, then click **Add Server**. + +1. Enter a name for your server in the **Server Name** box. This name will show up on the *Play Multiplayer* server selection screen. + +1. Paste your IP address in the **Server Address** field and click **Done**: + + ![Paste your IP address in the Server Address field.](minecraft-one-click-edit-server-info.png) + +1. Once your server is ready to play on, the status indicator will show a series of green bars. + + ![A Minecraft server that is ready to accept connections](minecraft-one-click-server-selection-screen.png) + + If there is a red *X* over the status bars, or it says *old*, then your Linode has not finished installing Minecraft. Wait a few minutes, then hit **Refresh**. + +### Software Included + +The Minecraft One-Click App will install the following required software on your Linode: + +| **Software** | **Description** | +|:--------------|:------------| +| [**Minecraft 1.13**](https://www.minecraft.net/en-us/) | Game server. | +| [**LinuxGSM**](https://linuxgsm.com) | A command line tool for the deployment and management of Linux game servers. | +| [**UFW**](https://wiki.ubuntu.com/UncomplicatedFirewall) | Firewall utility. Port 25575 will allow outgoing and incoming traffic. | +| [**Fail2ban**](https://www.fail2ban.org/wiki/index.php/Main_Page) | Fail2Ban is an intrusion prevention software framework that protects computer servers from brute-force attacks. | \ No newline at end of file diff --git a/docs/platform/one-click/deploying-minecraft-with-one-click-apps/minecraft-one-click-edit-server-info.png b/docs/platform/one-click/deploying-minecraft-with-one-click-apps/minecraft-one-click-edit-server-info.png new file mode 100644 index 00000000000..c90bd47f70c Binary files /dev/null and b/docs/platform/one-click/deploying-minecraft-with-one-click-apps/minecraft-one-click-edit-server-info.png differ diff --git a/docs/platform/one-click/deploying-minecraft-with-one-click-apps/minecraft-one-click-server-selection-screen.png b/docs/platform/one-click/deploying-minecraft-with-one-click-apps/minecraft-one-click-server-selection-screen.png new file mode 100644 index 00000000000..3907b172221 Binary files /dev/null and b/docs/platform/one-click/deploying-minecraft-with-one-click-apps/minecraft-one-click-server-selection-screen.png differ diff --git a/docs/platform/one-click/deploying-rust-with-one-click-apps/index.md b/docs/platform/one-click/deploying-rust-with-one-click-apps/index.md new file mode 100644 index 00000000000..712aa567eff --- /dev/null +++ b/docs/platform/one-click/deploying-rust-with-one-click-apps/index.md @@ -0,0 +1,93 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Deploy a Rust server on Linode using One-Click Apps.' +keywords: ['rust','one-click', 'server'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-03-25 +modified: 2019-03-25 +modified_by: + name: Linode +title: "Deploy Rust with One-Click Apps" +contributor: + name: Linode +external_resources: +- '[Rust Dedicated Server Wiki](https://developer.valvesoftware.com/wiki/Rust_Dedicated_Server)' +--- + +## Rust One-Click App + +[Rust](https://rust.facepunch.com/) is a multiplayer game where you play as a survivor that must work with or against other players to ensure your own survival. Players are able to steal, lie, cheat, or trick each other. You can build a shelter, hunt animals for food, craft weapons and armor, and much more. + +Hosting your own Rust server allows you to customize settings and curate the number of players in the world. + +### Deploy a Rust One-Click App + +{{< content "deploy-one-click-apps">}} + +The [Rust Options](#rust-options) section of this guide provides details on all available configuration options for this app. + +### Rust Options + +You can configure your Rust App by providing values for the following fields: + +| **Field** | **Description** | +|:--------------|:------------| +| **RCON Password** | The password for your remote console, which allows you to issue commands on the Rust server *Required*. | +| **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 Options* | +| **Server Hostname** | The name of your Rust server. *Advanced Options* | +| **Server Description** | Your server's description. Use `\n` to create a new line. *Advanced Options* | +| **Maximum Players** | The maximum number of players allowed on a server at one time. Default is 50, minimum is 10, maximum is 100. *Advanced Options* | +| **World** | Sets the type of map to generate. Options are Procedural Map, Barren, Hapis Island, Savas Island. *Advanced Options*. +| **World Size** | The size of the world map. Default is 3000, minimum is 1000, maximum is 8000. *Advanced Options* | +| **Seed** | A random numeric seed used by the world generation algorithm to create a unique world. The maximum value is 4,294,967,295. *Advanced Options* | +| **Global Chat Enabled** | Enables global chat. Chat messages will be broadcast to all players. *Advanced Options* | +| **PvE Enabled** | Allow player vs. environment combat. *Advanced Options* | + +### 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 Rust 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). Your Rust server should be sized based on the amount of traffic you are expecting on your server as well as the game play performance you are looking for. We recommend using a 8GB Linode as the smallest plan to ensure good performance of your game server. A 8GB Dedicated plan will provide better game performance. 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. **Rust should install between 5-15 minutes after your Linode has successfully provisioned**. + +## Getting Started after Deployment + +Ensure that you have installed Rust to your computer before getting started with this section. You can install Rust from [Steam's Web Store](https://store.steampowered.com/). + +After the Rust One-Click App has finished deploying to your Linode, you will be able to access your Rust server by copying your Linode's IPv4 address and entering it in to the Rust game installed on your computer. 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. + +2. Find the Linode you just created when deploying your app and select it. + +3. Navigate to the **Networking** tab. + +4. Under the **IPv4** heading, you will find your IPv4 address listed under the **Address** column. + +5. Copy the IPv4 address. Open Rust, and then open the developer's console by pressing `f1`. + +6. In the console, type `connect 192.0.2.155:28015` and replace 192.0.2.155 with your Linode's IP address. Be sure append the port `28015` to the end of the IP address. Press **enter** when you are done typing. + + + + You will be logged into the server, and the game will load. + +### Software Included + +The Rust One-Click App will install the following required software on your Linode: + +| **Software**        | **Description** | +|:--------------|:------------| +| [**Rust Server**](https://store.steampowered.com/app/252490/Rust/) | Game server. | +| [**LinuxGSM**](https://linuxgsm.com) | A command line tool for the deployment and management of Linux game servers. | +| [**UFW**](https://wiki.ubuntu.com/UncomplicatedFirewall) | Firewall utility. Ports 28015 and 28016 will allow outgoing and incoming traffic. | +| [**Fail2ban**](https://www.fail2ban.org/wiki/index.php/Main_Page) | Fail2Ban is an intrusion prevention software framework that protects computer servers from brute-force attacks. | \ No newline at end of file diff --git a/docs/platform/one-click/deploying-rust-with-one-click-apps/rust-one-click-developers-console.png b/docs/platform/one-click/deploying-rust-with-one-click-apps/rust-one-click-developers-console.png new file mode 100644 index 00000000000..11ea5f4684a Binary files /dev/null and b/docs/platform/one-click/deploying-rust-with-one-click-apps/rust-one-click-developers-console.png differ diff --git a/docs/platform/one-click/deploying-team-fortress-2-with-one-click-apps/index.md b/docs/platform/one-click/deploying-team-fortress-2-with-one-click-apps/index.md new file mode 100644 index 00000000000..6af6a96b0f1 --- /dev/null +++ b/docs/platform/one-click/deploying-team-fortress-2-with-one-click-apps/index.md @@ -0,0 +1,93 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Deploy a Team Fortress 2 server on Linode using One-Click Apps.' +keywords: ['team fortress','one-click', 'tf2', 'server'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-04-04 +modified: 2019-03-04 +modified_by: + name: Linode +title: "Deploy a Team Fortress 2 Server with One-Click Apps" +contributor: + name: Linode +--- + +## Team Fortress 2 One-Click App + +Team Fortress 2 (TF2) is a team-based multiplayer first-person shooter game. In TF2, you and your team choose from 9 unique classes and play against an enemy team in a variety of game modes. These modes include capture the flag, king of the hill, and even a battle pitting your team against a robotic horde. + +Setting up a personal game server puts you in control of the game modes and maps you use, as well as a variety of other settings to customize your experience. + +### Deploy a Team Fortress 2 One-Click App + +{{< content "deploy-one-click-apps">}} + +The [Team Fortress 2 Options](#team-fortress-2-options) section of this guide provides details on all available configuration options for this app. + +### Team Fortress 2 Options + +You can configure your Team Fortress 2 App by providing values for the following fields: + +| **Field** | **Description** | +|:--------------|:------------| +| **RCON Password** | The password for the remote console, which allows you to issue commands on the TF2 server. *Required*. | +| **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 Options*. | +| **Server Name** | Your Team Fortress 2 server's name. *Advanced Options*. | +| **Message of the Day** | Message of the day. Text displayed whenever a player logs on to the server. *Advanced Options* | +| **Server Password** | The password for the TF2 server. Configuring a TF2 server password will require users of your game server to provide this password. *Advanced Options* | +| **Game Server Login Token** | A Steam game server login token. This is required to publicly list your server. To get a Steam Token, visit the [Steam Game Server Account Management](https://steamcommunity.com/dev/managegameservers) page. *Advanced Options* | +| **Team Balance Enabled** | Automatically balance the number of players on a team. *Advanced Options* | +| **Maximum Rounds** | The maximum amount of rounds before the map changes. *Advanced Options* | +| **Round Time Limit** | The time per round, in minutes. *Advanced Options* | + + +### 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 Team Fortress 2 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). Your TF2 server should be sized based on the amount of traffic you are expecting on your server as well as the game play performance you are looking for. We recommend using a 2GB Linode as the smallest plan to ensure good performance of your game server, though 4GB as a minimum size would ensure better performance of your game server. 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 Team Fortress 2 app should install between 5-15 minutes after your Linode has successfully provisioned**. + +## Getting Started after Deployment + +Ensure that you have installed Team Fortress 2 to your computer before getting started with this section. You can install Team Fortress 2 from [Steam's Web Store](https://store.steampowered.com/app/440/Team_Fortress_2/). + +After the Team Fortress 2 Server One-Click App has finished deploying to your Linode, you will be able to access your server by copying your Linode's IPv4 address and connecting to it within the game installed on your computer. To find your Linode's IPv4 address and connect to it: + +1. Click on the **Linodes** link in the sidebar. You will see a list of all your Linodes. + +2. Find the Linode you just created when deploying your app and select it. + +3. Navigate to the **Networking** tab. + +4. Under the **IPv4** heading, you will find your IPv4 address listed under the **Address** column. + +5. Copy the IPv4 address. + +6. Open Team Fortress 2 on your computer, then open the developer's console by pressing the back tick key (**`**). + +7. Type `connect 192.0.2.155`. Replace 192.0.2.155 with the IP address of your Linode, and then click **Submit**. + + ![The Team Fortress 2 developer's console.](one-click-tf2-developers-console.png) + + You will connect to the server. + +### Software Included + +The Team Fortress 2 One-Click App will install the following required software on your Linode: + +| **Software** | **Description** | +|:--------------|:------------| +| [**Team Fortress 2**](http://www.teamfortress.com/) | Game server. | +| [**LinuxGSM**](https://linuxgsm.com) | A command line tool for the deployment and management of Linux game servers. | +| [**UFW**](https://wiki.ubuntu.com/UncomplicatedFirewall) | Firewall utility. Ports 27014:27050/tcp, 3478:4380/udp, 27000:27030/udp, and 26901 will allow outgoing and incoming traffic. | +| [**Fail2ban**](https://www.fail2ban.org/wiki/index.php/Main_Page) | Fail2Ban is an intrusion prevention software framework that protects computer servers from brute-force attacks. | \ No newline at end of file diff --git a/docs/platform/one-click/deploying-team-fortress-2-with-one-click-apps/one-click-tf2-developers-console.png b/docs/platform/one-click/deploying-team-fortress-2-with-one-click-apps/one-click-tf2-developers-console.png new file mode 100644 index 00000000000..f6ec5cedc2b Binary files /dev/null and b/docs/platform/one-click/deploying-team-fortress-2-with-one-click-apps/one-click-tf2-developers-console.png differ diff --git a/docs/platform/one-click/deploying-terraria-with-one-click-apps/index.md b/docs/platform/one-click/deploying-terraria-with-one-click-apps/index.md new file mode 100644 index 00000000000..093b7329e39 --- /dev/null +++ b/docs/platform/one-click/deploying-terraria-with-one-click-apps/index.md @@ -0,0 +1,108 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Deploy a Terraria server on Linode using One-Click Apps.' +keywords: ['terraria','one-click app', 'game server'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-04-05 +modified: 2019-04-05 +modified_by: + name: Linode +title: "Deploy a Terraria Server with One-Click Apps" +contributor: + name: Linode +external_resources: + - '[The Official Terraria Wiki](https://terraria.gamepedia.com/Terraria_Wiki)' +--- + +## Terraria One-Click App + +Terraria is a two-dimensional sandbox game in which players explore the world, collect resources, build structures, and battle enemies in procedurally generated environments. In Terraria a player begins by digging for ore, and the further they dig the more adventure they find. Multiplayer mode can be either cooperative or PvP. + +Hosting your own Terraria server gives you control over the world, the players, and the objectives. Your world, your rules. + +### Deploy a Terraria One-Click App + +{{< content "deploy-one-click-apps">}} + +The [Terraria Options](#terraria-options) section of this guide provides details on all available configuration options for this app. + +### Terraria Options + +You can configure your Terraria One-Click App by providing values for the following fields: + +| **Field** | **Description** | +|-----------|-----------------| +| **Steam Username** | Your [Steam username](https://store.steampowered.com). [Steam Guard](https://support.steampowered.com/kb_article.php?ref=4020-ALZM-5519) must be turned off. *Required*. | +| **Steam Password** | Your Steam password. *Required*. | +| **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*. | +| **World Name** | The name of the Terraria virtual [world](https://terraria.gamepedia.com/World). *Advanced Configuration*. | +| **Server Password** | The server's password, if you would like to make the server password protected. *Advanced Configuration*. | +| **Message of the Day** | The message of the day text that is displayed whenever a player logs on to the server. *Advanced Configuration*. | +| **Difficulty Level** | The world difficulty level. *Advanced Configuration*. | +| **Maximum Players** | The maximum amount of players allowed on the server. A number from 1-255. *Advanced Configuration*. | +| **Port** | The port number that the game server listens on. *Advanced Configuration*. | +| **Seed** | A [random seed](https://terraria.gamepedia.com/World_Seed) used by the world generation algorithm to create a unique world. For example: `qazwsx123`. *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 the Terraria One-Click App, 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). Your Terraria server should be sized based on the amount of traffic you are expecting on your server as well as the game play performance you are looking for. We recommend using a 8GB Linode as the smallest plan to ensure good performance of your game server. 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. **Terraria should install between 5-15 minutes after your Linode has successfully provisioned**. + +## Getting Started after Deployment + +After Terraria has finished installing, you will be able to access your server by copying your Linode's IPv4 address from the [Linode Cloud Manager](https://cloud.linode.com) and then connecting to it within the game. + +{{< caution >}} +You must disable Steam Guard to connect to your Terraria server. If you don't disable Steam Guard, you may be locked out of your account and will need to reset your password. To disable Steam Guard, navigate to the Steam Preferences menu, then open the **Account** pane. Click on **Manage Steam Guard Account Security**, then click on **Turn Steam Guard off**. +{{}} + +To find your Linode's IPv4 address and connect to it: + +1. Click on the **Linodes** link in the sidebar. You will see a list of all your Linodes. + +2. Find the Linode you just created when deploying your app and select it. + +3. Navigate to the **Networking** tab. + +4. Your IPv4 address will be listed under the **Address** column in the **IPv4** table. + +5. Copy the IPv4 address. + +6. Open Terraria, then click **Multiplayer**. + +7. Click on **Join via IP**. + +8. You will be prompted to select a character, or create a new one if you don't have any characters. Select or create a character. + +9. Type in your IP address, then click **Accept**. + + ![Enter your Linode's IP address.](terraria-one-click-enter-ip.png) + +10. You will be prompted to enter in your Terraria One-Click App's port. If you did not specify a different port in the advanced configuration section, use port 7777. Click **Accept**. + + ![Enter the Terraria server's port](terraria-one-click-enter-port.png) + + You will be connected to the server. + +### Software Included + +The Terraria One-Click App will install the following required software on your Linode: + +| **Software** | **Description** | +|--------------|-----------------| +| [**Terraria**](https://terraria.org) | Game server. | +| [**LinuxGSM**](https://linuxgsm.com) | A command line tool for the deployment and management of Linux game servers. | +| [**UFW**](https://wiki.ubuntu.com/UncomplicatedFirewall) | Firewall utility. Port 7777, unless otherwise specified, will allow outgoing and incoming tcp and udp traffic. | +| [**Fail2ban**](https://www.fail2ban.org/wiki/index.php/Main_Page) | Fail2Ban is an intrusion prevention software framework that protects computer servers from brute-force attacks. | \ No newline at end of file diff --git a/docs/platform/one-click/deploying-terraria-with-one-click-apps/terraria-one-click-enter-ip.png b/docs/platform/one-click/deploying-terraria-with-one-click-apps/terraria-one-click-enter-ip.png new file mode 100644 index 00000000000..be7967c43f3 Binary files /dev/null and b/docs/platform/one-click/deploying-terraria-with-one-click-apps/terraria-one-click-enter-ip.png differ diff --git a/docs/platform/one-click/deploying-terraria-with-one-click-apps/terraria-one-click-enter-port.png b/docs/platform/one-click/deploying-terraria-with-one-click-apps/terraria-one-click-enter-port.png new file mode 100644 index 00000000000..f76d80361d3 Binary files /dev/null and b/docs/platform/one-click/deploying-terraria-with-one-click-apps/terraria-one-click-enter-port.png differ 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 diff --git a/docs/platform/one-click/how-to-use-one-click-apps-at-linode/index.md b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/index.md new file mode 100644 index 00000000000..4c3bb65bfb0 --- /dev/null +++ b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/index.md @@ -0,0 +1,111 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'How to deploy a One-Click App using the Linode Cloud Manager.' +keywords: ['manager','cloud','app','one click'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-03-26 +modified: 2019-03-26 +modified_by: + name: Linode +title: "How to Use Linode's One-Click Apps" +contributor: + name: Linode +--- + +One-Click Apps help you easily deploy and configure software on a Linode from a list of various apps that are built into the Linode [Cloud Manager](https://cloud.linode.com), without the hassle of using the command line. Of course, you'll still have full access to your Linode if you want to log in to your server and have a more hands-on approach later on. + +When a One-Click App is deployed, a new Linode is created and the appropriate software is installed with the configurations you provide. One-Click Apps does not install software to already-existing Linodes in your account. This guide presents instructions for where to find One-Click Apps in the Cloud Manager and how deploy WordPress blogs, WooCommerce stores, your favorite game servers, and more. + +## Deploying an App + +1. Log in the the Linode [Cloud Manager](https://cloud.linode.com). + +1. Click **Create** at the top of the screen and choose **Linode** from the dropdown menu that appears: + + ![Click 'Create' at the top of the screen and choose 'Linode' from the dropdown menu.](one-click-create-a-linode.png "Click 'Create' at the top of the screen and choose 'Linode' from the dropdown menu.") + +1. The Linode creation page will appear. Select the **One-Click** tab: + + ![Select the 'One-Click' tab on the Create New Linode page.](one-click-select-one-click-tab.png) + +1. The **Create From** section of the page's form will appear. Ensure that the **One-Click Apps** tab is selected in this section: + + ![The `One-Click` menu.](one-click-create-from-one-click-apps.png) + +1. Select the app you would like to create. For this example, WordPress will be selected: + + ![Select WordPress.](one-click-select-wordpress.png) + +1. After the **Select App** section you'll find a new section with additional configuration options specific to your app. Fill out the required options; they will be marked with an asterisk. In the case of WordPress, you'll find fields for the WordPress administrator's username, password, and e-mail address. + + ![Fill out the required Options fields, which are marked with an asterisk.](one-click-wordpress-config-options.png) + + You can fill out additional options by clicking on **Show Advanced Options**. For the WordPress example, these options are the site's title and a field for an [SSH key](/docs/security/authentication/use-public-key-authentication-with-ssh/). If you enter an SSH key, you will be able to use it later to log in to your Linode ([via SSH](/docs/getting-started/#connect-to-your-linode-via-ssh)). + +1. The **Select an Image** section displays that Debian is pre-selected. This is the underlying operating system that your Linode will run. + +1. Under the **Region** section, choose which data center you would like your app to be deployed. Choose a region that is close to your audience's geographic location. When you are closer to your data center, your network speeds will generally be higher, and your network latency will be lower. + +1. Choose which plan you'd like to use under the **Linode Plan** section. Your plan specifies the hardware resources assigned to your server. The resources that you need are determined by the requirements of your app. Linode's plans are split into four types: Nanode, Standard, Dedicated CPU, and High Memory. + + For small sites like WordPress blogs a 1GB Nanode is usually enough, and for video game servers a 2GB or 4GB Standard Linode is often a good choice. Some game servers may benefit from the Dedicated CPU plans. Our [How to Choose a Linode Plan](/docs/platform/how-to-choose-a-linode-plan/) guide presents more information about the different use-cases for each plan. + + {{< note >}} +You can always upgrade your Linode later if you need more memory, CPU cores, or any of the other hardware resources. Also, you can downgrade your plan if you think you don't need as much as you're currently using. Furthermore, you can change plan types entirely, like going from a Standard Linode to a Dedicated CPU Linode. + +Review the [Resizing a Linode](/docs/platform/disk-images/resizing-a-linode/) guide for upgrading and downgrading instructions. When downgrading your plan, the size of your Linode's disk must fit within the new plan's disk space allocation. +{{}} + +1. For this example, a 1GB Nanode is selected. + + ![Choose a plan.](one-click-pick-plan.png) + +1. Create a label and (optionally) select tags for your Linode. The label is your Linode's name and must be unique among all the Linodes on your account. [Tags](/docs/quick-answers/linode-platform/tags-and-groups/) are used to organize your Linodes within the Cloud Manager. + +1. Create a root password. This is **not** the password for your WordPress site, game, or other application. Instead, this is the password for the Linode server. You will need it if you ever decide to perform maintenance on your server in the future. + + It is strongly recommended that you create a long, complex, and unique password and store it somewhere secure for future reference. If you forget your root password, check out our [Reset the Root Password on Your Linode](/docs/quick-answers/linode-platform/reset-the-root-password-on-your-linode/) guide to create a new one. + + {{< note >}} +A strong password is the first step in securing your server and avoiding potential vulnerabilities for anyone trying to exploit your server. For more information on securing your server, check out our [How to Secure Your Server](/docs/security/securing-your-server/) guide. +{{< /note >}} + +1. Click **Create**. You will be taken to the Linode's Dashboard where you can monitor the status of your Linode's creation. + + Once your Linode has been created, the Cloud Manager will then start to deploy your app in the background. **This will take several minutes**. Once your app has been deployed it will be available at the IP address of the Linode you created. If you visit your IP address before the app is ready, try again a few minutes later. + +## Accessing Your App + +Depending on the type of app you created, the app will be accessible in different ways. All the ways to access your app require the IP address of your Linode. Follow the instructions below to find your IP address. + +1. Log in to the [Cloud Manager](https://cloud.linode.com). + +1. Navigate to the Linodes page by clicking on the **Linodes** link in the sidebar. + +1. Find the Linode that you created. The IP address is a series of four numbers separated by periods. In the grid view of the Linodes page, your IP address will be located underneath the data center name for your Linode: + + ![Highlight of a Linode's IP address in grid view.](one-click-ip-address-grid.png) + +1. In list view, your IP address will be under the **IP Addresses** column in the row that lists your Linode: + + ![Highlight of a Linode's IP address in list view.](one-click-ip-address-list.png) + +1. Alternatively, you can find your IP address by navigating to the **Networking** tab of your Linode's detail page. The address is displayed under the **Address** column in the **IPv4** table: + + ![View your IP address from the Networking tab of the Linode detail page.](one-click-networking-tab.png) + +1. Copy your IP address. For apps like WordPress, WooCommerce, and Drupal, you can navigate to the IP address in your browser to visit your installation. For game servers, connect to the IP address in-game to play on your new server. Other apps like MERN, LAMP, and WireGuard will require you to SSH into your Linode to access or provide more customized configurations. + +## Adding a Domain Name for Your App + +For websites like WordPress, WooCommerce, and Drupal, it's much more desirable to have a domain name rather than using an IP address to access your app. + +For information on how to add a domain name to your app, visit our [DNS Manager](/docs/platform/manager/dns-manager/) guide. Specifically, you will want to [set up an *A record*](/docs/platform/manager/dns-manager/#add-dns-records) and assign your IP address to it. For more general information about how DNS works, review the the [DNS Records: An Introduction](/docs/networking/dns/dns-records-an-introduction/) guide. + +## Connecting to your Server Remotely + +Every One-Click App is deployed to its own Linode instance, and you can access the operating system for your app's server if you choose to. To gain command-line access to your server, [log in using a Secure Shell (SSH) client](/docs/getting-started/#connect-to-your-linode-via-ssh) on your computer. + +When logging in over SSH, use `root` as the username, and supply the root password that you specified when you deployed your app. Follow our [Getting Started guide](/docs/getting-started/#connect-to-your-linode-via-ssh) to learn more about connecting to your Linode via SSH. If you use Windows at home, our [Using SSH on Windows](/docs/networking/ssh/using-ssh-on-windows/) guide has special instructions for Windows SSH clients. If you're new to Linux, some of the guides in our [Linux](/docs/quick-answers/linux/) and [Linux Essentials](/docs/quick-answers/linux-essentials/) sections may be useful. \ No newline at end of file diff --git a/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-create-a-linode.png b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-create-a-linode.png new file mode 100644 index 00000000000..9b383cdaad3 Binary files /dev/null and b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-create-a-linode.png differ diff --git a/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-create-from-one-click-apps.png b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-create-from-one-click-apps.png new file mode 100644 index 00000000000..367dcf4d987 Binary files /dev/null and b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-create-from-one-click-apps.png differ diff --git a/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-ip-address-grid.png b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-ip-address-grid.png new file mode 100644 index 00000000000..06d8e1e3f7d Binary files /dev/null and b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-ip-address-grid.png differ diff --git a/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-ip-address-list.png b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-ip-address-list.png new file mode 100644 index 00000000000..6aad0c98f7d Binary files /dev/null and b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-ip-address-list.png differ diff --git a/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-networking-tab.png b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-networking-tab.png new file mode 100644 index 00000000000..b249531613c Binary files /dev/null and b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-networking-tab.png differ diff --git a/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-pick-plan.png b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-pick-plan.png new file mode 100644 index 00000000000..6c8c78e0aa5 Binary files /dev/null and b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-pick-plan.png differ diff --git a/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-select-one-click-tab.png b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-select-one-click-tab.png new file mode 100644 index 00000000000..963e115b3b8 Binary files /dev/null and b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-select-one-click-tab.png differ diff --git a/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-select-wordpress.png b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-select-wordpress.png new file mode 100644 index 00000000000..8d861a1eaa6 Binary files /dev/null and b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-select-wordpress.png differ diff --git a/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-wordpress-config-options.png b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-wordpress-config-options.png new file mode 100644 index 00000000000..f8f10349e2a Binary files /dev/null and b/docs/platform/one-click/how-to-use-one-click-apps-at-linode/one-click-wordpress-config-options.png differ diff --git a/docs/platform/one-click/one-click-openvpn/index.md b/docs/platform/one-click/one-click-openvpn/index.md new file mode 100644 index 00000000000..5b4285f5081 --- /dev/null +++ b/docs/platform/one-click/one-click-openvpn/index.md @@ -0,0 +1,67 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Deploy an OpenVPN Server on Linode with One-Click Apps.' +keywords: ['vpn','openvpn','tunnel',one-click app'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-04-05 +modified_by: + name: Linode +title: "Deploy OpenVPN Access Server with One-Click Apps" +contributor: + name: Linode +external_resources: +- '[OpenVPN Community Resources](https://openvpn.net/community-resources/)' +--- + +## OpenVPN One-Click App + +OpenVPN is a widely trusted, free, and open-source VPN (virtual private network) application that creates encrypted tunnels for secure data transfer between computers that are not on the same local network. Your traffic is encrypted by OpenVPN using [OpenSSL](https://www.openssl.org/). You can use OpenVPN to: + +- Connect your computer to the public Internet through a dedicated OpenVPN server. By encrypting your traffic and routing it through an OpenVPN server that you control, you can protect yourself from network attacks when using public Wi-Fi. + +- Connect your computer to services that you don't want to expose to the public Internet. Keep your sensitive applications isolated on your servers' private networking and use OpenVPN to access them remotely. + +## Deploy OpenVPN with One-Click Apps + +{{< content deploy-one-click-apps >}} + +### OpenVPN Options + +| **Field** | **Description** | +|:--------------|:------------| +| **VPN Password** | The password you'll use when connecting to your VPN. *Required*. | +| **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 the OpenVPN One-Click App, 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). You can use any size Linode for your OpenVPN App. The Linode plan that you select should be representative of the amount of data transfer and users you expect for your VPN. For personal usage, you can create your VPN on a Nanode or 2GB Linode and should see good performance, unless you are performing intensive data transfers across your VPN. 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. **OpenVPN will take anywhere from 2-5 minutes to install after your Linode has provisioned**. + +## Getting Started After Deployment + +Your VPN's administrative web interface will be available via a web browser at `https://192.0.2.2:943/admin/`, where `192.0.2.2` represents the IPv4 address of your new Linode instance. Your IPv4 address can be found under the **Networking** tab on your new Linode's detail page. + +The client web interface for your VPN is located at `https://192.02.2:943/`, where your Linode's IP address should take the place of the `192.0.2.2` example address. The client interface includes links to download the OpenVPN client software for your computer. + +The username you should use to log in to your OpenVPN server is `openvpn`. The password for connecting to the VPN is the password you supplied in the One-Click App creation form. + +### Open a Connection to your VPN + +To open a connection to your OpenVPN server from your computer, you'll need to install the OpenVPN client software. Follow the instructions in the [Client Software Installation](/docs/networking/vpn/install-openvpn-access-server-on-linux/#client-software-installation) section of our [OpenVPN](/docs/networking/vpn/install-openvpn-access-server-on-linux/#client-software-installation) guide for a detailed explanation of how to install and use this software. + +### Software Included + +| **Software** | **Description** | +|--------------|-----------------| +| [**OpenVPN Access Server**](https://openvpn.net/vpn-server/) | VPN server software. | \ No newline at end of file diff --git a/docs/platform/one-click/one-click-woocommerce/index.md b/docs/platform/one-click/one-click-woocommerce/index.md new file mode 100644 index 00000000000..a176cc6104c --- /dev/null +++ b/docs/platform/one-click/one-click-woocommerce/index.md @@ -0,0 +1,110 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'Use One-Click Apps to deploy a Linode running WordPress and the popular eCommerce plugin, WooCommerce.' +keywords: ['woocommerce','wordpress','one-click apps','ecommerce','e-commerce','cms'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-04-02 +modified_by: + name: Linode +title: "Deploy WooCommerce with One-Click Apps" +contributor: + name: Linode +external_resources: +- '[WooCommerce Docs](https://docs.woocommerce.com/)' +- '[Introduction to eCommerce for WordPress](https://woocommerce.com/guides/ecommerce-for-wordpress-intro/)' +- '[New Store Owners Guide](https://woocommerce.com/guides/new-store/)' +- '[WooCommerce Storefront Theme](https://woocommerce.com/storefront/)' +- '[WooCommerce Themes by Industry](https://woocommerce.com/product-category/themes/storefront-child-theme-themes/)' +- '[WooCommerce Extensions](https://woocommerce.com/product-category/woocommerce-extensions/)' +--- +## WooCommerce One-Click App + +[WooCommerce](https://woocommerce.com/) is a popular open source eCommerce plugin for WordPress that can power online storefronts to sell both digital and physical products for small-to-large businesses. A variety of [themes for WooCommerce](https://woocommerce.com/product-category/themes/storefront-child-theme-themes/) are available so you can create a store that looks the way you want it to. WooCommerce takes payments via major credit cards, bank transfers, [PayPal](https://woocommerce.com/products/woocommerce-gateway-paypal-checkout/), and other providers like [Stripe](https://woocommerce.com/products/stripe/). The WooCommerce plugin is free, but some themes and extensions have a cost. + +## Deploy WooCommerce with One-Click Apps + +{{< content deploy-one-click-apps >}} + +### WooCommerce Options + +| **Field** | **Description** | +|--------------|------------| +| **Admin Username** | Username for your WordPress admin user. WooCommerce is managed through the [WordPress administrative interface](https://codex.wordpress.org/Administration_Screens). *Required*. | +| **Admin Password** | Password for your WordPress admin user. *Required*. | +| **Email Address** | Email address for your WordPress admin user. *Required*. | +| **Website Title** | The title that will appear at the top of your WooCommerce site. *Advanced Options*. | +| **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 Options*. | + +### 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 the WooCommerce One-Click App, 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). As a plugin for WordPress, WooCommerce is an extremely flexible CMS that can be supported on any size Linode. We suggest you build your WooCommerce app on a Linode plan that reflects how much content you plan on featuring, as well as how much traffic you plan on having on your site. For small sites, a 1GB Nanode or a 2GB Linode should be enough. 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 WooCommerce app will complete installation anywhere between 2-5 minutes after your Linode has finished provisioning.** After WooCommerce has finished installing, a confirmation email will be sent to the email address you provided during configuration, at which point you will be able to [access your site](#getting-started-after-your-deployment). + +## Getting Started After Deployment + +### Access Your WooCommerce Site + +After WooCommerce and WordPress have finished installing, you will be able to access your 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 WooCommerce site's home page. + +1. Once you have accessed your site via the browser, you can log in to the WordPress administrative interface and [start configuring your store](#complete-the-woocommerce-setup-wizard). + + 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 WooCommerce 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 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. + +### Complete the WooCommerce Setup Wizard + +When you first log in to the WordPress admin interface, you will be presented with a banner that asks you to complete the WooCommerce setup wizard: + +![WooCommerce Setup Wizard Banner](woocommerce_setup_wizard_banner.png "WooCommerce setup wizard banner") + +Click on the **Run the Setup Wizard** button to visit this form and start your store configuration. + +### Software Included + + +| **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. | +| [**WooCommerce**](https://woocommerce.com/) | An online storefront plugin for WordPress. | \ No newline at end of file diff --git a/docs/platform/one-click/one-click-woocommerce/woocommerce_setup_wizard_banner.png b/docs/platform/one-click/one-click-woocommerce/woocommerce_setup_wizard_banner.png new file mode 100644 index 00000000000..2d2c9f719ea Binary files /dev/null and b/docs/platform/one-click/one-click-woocommerce/woocommerce_setup_wizard_banner.png differ diff --git a/docs/platform/one-click/one-click-woocommerce/wordpress-login.png b/docs/platform/one-click/one-click-woocommerce/wordpress-login.png new file mode 100644 index 00000000000..75597086a90 Binary files /dev/null and b/docs/platform/one-click/one-click-woocommerce/wordpress-login.png differ diff --git a/docs/platform/one-click/one-click-woocommerce/wordpress_general_settings_menu_option_highlighted.png b/docs/platform/one-click/one-click-woocommerce/wordpress_general_settings_menu_option_highlighted.png new file mode 100644 index 00000000000..51db674dea5 Binary files /dev/null and b/docs/platform/one-click/one-click-woocommerce/wordpress_general_settings_menu_option_highlighted.png differ diff --git a/docs/platform/tokyo2-migration/index.md b/docs/platform/tokyo2-migration/index.md index 64f650b4f06..2f6308af8e0 100644 --- a/docs/platform/tokyo2-migration/index.md +++ b/docs/platform/tokyo2-migration/index.md @@ -5,7 +5,6 @@ author: description: Linode is retiring our Tokyo 1 data center, and this guide shows how to migrate to our new Tokyo 2 location. keywords: ["tokyo 1", "tokyo 2", "migrate", "migration", "migrating", "data center"] license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' -modified: 2018-12-31 modified_by: name: Linode published: 2018-12-31 @@ -26,9 +25,9 @@ The Tokyo 2 data center provides access to features that are not available in To ## When will My Linodes be Migrated? -You will receive a support ticket from Linode that lists the scheduled dates and times for the migrations of your Tokyo 1 Linodes. This ticket will be sent to you at least two months in advance of the start of your first migration. +The [Linode Classic Manager](https://http://manager.linode.com) will display the scheduled dates and times for the migrations of your Tokyo 1 Linodes. If you visit the Classic Manager before this schedule is set by Linode, the information will not be displayed. -Different Linodes will be scheduled to migrate on different dates and times. The support ticket you receive will list the migration schedule for all of your Tokyo 1 Linodes. **Linode will not be able to adjust this schedule of migrations.** +When your migration schedule first becomes visible in the Classic Manager, you will receive a support ticket from Linode to let you know. This ticket will be sent to you at least two months in advance of the start of your first migration. Your different Linodes will be scheduled to migrate on different dates and times. **Linode will not be able to adjust this schedule of migrations.** You are able to move your servers to Tokyo 2 before the scheduled migration dates. We recommend that all customers move their servers early. Moving early will help you better control the uptime of your services. @@ -36,20 +35,24 @@ You are able to move your servers to Tokyo 2 before the scheduled migration date If your Tokyo 1 Linode is enrolled in the [Linode Backup Service](https://www.linode.com/backups), it will remain enrolled in the service after the migration. However, the saved backups and snapshots that have been created for your Linode prior to the migration **will not move** to the new Tokyo 2 facility. Instead, your Linode will start creating new scheduled backups after it is migrated to the Tokyo 2 date center (according to its [backup schedule](/docs/platform/disk-images/linode-backup-service/#schedule-backups)). +{{< note >}} +Before migrating, we recommend that you create at least one backup **separate from the Linode Backup Service** for each of your Tokyo 1 Linodes. The [Backing Up your Data](https://linode.com/docs/security/backups/backing-up-your-data/) guide has suggestions for alternative ways to back up your Linode. +{{< /note >}} + ## What are My Options for Migrating? There are three different options for moving your servers to the Tokyo 2 data center. The first two of these methods can be followed before the scheduled migration deadlines for your Linodes. -Regardless of which option you choose, **all of your Tokyo 1 Linodes' IP addresses will change** when moving to the new location. This includes all public and private IPv4 addresses, as well as public and link-local IPv6 addresses. When the schedule for your Linodes' migrations is set, new IP addresses in the Tokyo 2 data center will be reserved in advance for each of your Tokyo 1 Linodes. These reserved addresses will be listed in the same support ticket that lists the schedule for your migrations. +Regardless of which option you choose, **all of your Tokyo 1 Linodes' IP addresses will change** when moving to the new location. This includes all public and private IPv4 addresses, as well as public and link-local IPv6 addresses. When the schedule for your Linodes' migrations is set, new IP addresses in the Tokyo 2 data center will be reserved in advance for each of your Tokyo 1 Linodes. These reserved addresses will be listed for each Linode under the [Remote Access tab](/docs/platform/manager/remote-access/) of the Linode's dashboard. Later sections in this guide describe how to update your [network interface configuration](#update-your-network-configuration) and [DNS records](#update-dns-records) to use the new IPs. ### Option 1: Migrate Early -When you receive the support ticket which lists your migration times, you will also see a new banner appear in the dashboard of each of your Tokyo 1 Linodes. This banner will give you the option to initiate an early migration of your Linode to Tokyo 2. +When you receive the support ticket which announces your Tokyo 1 Linodes' migrations, you will also see a new banner appear in the dashboard of each of your Tokyo 1 Linodes. This banner will give you the option to initiate an early migration of your Linode to Tokyo 2. {{< note >}} -The early migration banner will actually appear on your Tokyo 1 Linodes' dashboards before you receive the support ticket for your scheduled migrations. You will be able to perform a migration as soon as you see this banner. However, new IPs in the Tokyo 2 data center will not be reserved for your Linode until you receive the support ticket. +The early migration banner will actually appear on your Tokyo 1 Linodes' dashboards before you receive the support ticket which announces the migrations. You will be able to perform a migration as soon as you see this banner. However, new IPs in the Tokyo 2 data center will not be reserved for your Linode until you receive the support ticket. This means that if you migrate before you receive your ticket, you will not know what your new IP addresses will be before you start the migration. Once you start the early migration, your new Tokyo 2 IP addresses will become visible in the [Remote Access tab](/docs/platform/manager/remote-access/) of the Linode's dashboard. {{< /note >}} diff --git a/docs/security/linode-manager-security-controls/index.md b/docs/security/linode-manager-security-controls/index.md index 1cc425cf9d2..5508984db8a 100644 --- a/docs/security/linode-manager-security-controls/index.md +++ b/docs/security/linode-manager-security-controls/index.md @@ -6,7 +6,7 @@ description: 'How to use two-factor authentication and other security controls i og_description: 'This guide describes the security features of the Linode Cloud Manager, including two-factor authentication, IP address whitelisting, API access controls, forced password expiration, and more.' keywords: ["two-factor authentication", "password", "security", "Linode Cloud Manager", "token"] license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' -aliases: ['security/linode-manager-security-controls/','linode-manager-security/','security/linode-manager-security-controls-new-manager/'] +aliases: ['security/linode-manager-security-controls/','linode-manager-security/','security/linode-manager-security-controls-new-manager/','platform/manager/keep-your-linode-account-safe/' ] modified: 2019-01-08 modified_by: name: Linode diff --git a/docs/web-servers/nginx/how-to-configure-nginx/index.md b/docs/web-servers/nginx/how-to-configure-nginx/index.md index bb7b38c0699..afab7f24bbc 100644 --- a/docs/web-servers/nginx/how-to-configure-nginx/index.md +++ b/docs/web-servers/nginx/how-to-configure-nginx/index.md @@ -54,7 +54,7 @@ http { ## The http Block -The `http` block contains directives for handling web traffic. These directives are often referred to as *universal* because they are passed on to to all website configurations NGINX serves. See [the NGINX docs](https://nginx.org/en/docs/http/ngx_http_core_module.html) for a list of available directives for the `http` block. +The `http` block contains directives for handling web traffic. These directives are often referred to as *universal* because they are passed on to all website configurations NGINX serves. See [the NGINX docs](https://nginx.org/en/docs/http/ngx_http_core_module.html) for a list of available directives for the `http` block. {{< file "/etc/nginx/nginx.conf" nginx >}} http {