Knowledgebase

Introduction

Rcs's One-Click Drupal application is a quick way to launch your website. Select a server location, choose your size, and click Deploy Now. Your server will be ready to configure in about a minute.

1. Install SSL Certificate

This step is optional, but recommended. Most Drupal administrators will use a domain name and valid SSL certificate for their site. If you plan to use a commercial SSL certificate, see the Commercial SSL section.

If you skip this step:

• Substitute the server IP address for oneclick.example.com.
• You will encounter a certificate security warning.
• Proceed past the warning to complete setup. See our instructions to bypass the HTTPS warning for self-signed SSL/TLS certificates.

To install a free Let's Encrypt SSL certificate:

1. Register the server's domain name and create a DNS record for the server's IP address. Consult your DNS provider for instructions, or see our guide if using Rcs's DNS.

2. Verify that DNS has finished propagation and the name is visible throughout the internet before proceeding. Propagation usually happens quickly, but could take up to 48 hours in some cases.

3. Connect to your server, with the root login from the Server Information screen.

4. Install the certificate with certbot. Replace the domain name and email with your values.

    # certbot --nginx --redirect --agree-tos --no-eff-email -d oneclick.example.com -m admin@example.com 

   Certbot should report success when finished.

2. Run Installation Assistant

1. Navigate to https://oneclick.example.com/install.php to begin the Drupal installation.

2. Enter the Login user credentials in the security pop-up.

   

3. Choose your language, then click Save and continue.

4. Select your installation profile.

5. Enter the database information, located on the Server Information screen in the customer portal.

6. Wait for Drupal to initialize the database.

7. Enter the requested information on the Configure site screen. Click Save and continue.

Your site is installed. To log in, navigate to https://oneclick.example.com/user/login

More Information

Security Settings

For security, you should configure the trusted_host_patterns setting in /var/www/html/sites/default/default.settings.php after installation. See Trusted Host settings at drupal.org.

Themes and Modules

One-Click Drupal supports uploaded themes and modules up to 2GB each. These can be configured in the "Modules" and "Appearance" sections, after logging into Drupal as an administrator user.

MySQL

A MySQL database is running on your VPS for Drupal. If you need to access the database directly:

1. Connect to the server via ssh as root.

2. Log into MySQL.

    # mysql -u root

   The MySQL root password is saved in /root/.my.cnf.

Nginx Issues

If you need to reset Nginx to default:

1. Connect to the server via ssh as root.

2. Run the fix-vhost.sh script.

    # /opt/vultr/fix-vhost.sh

Commercial SSL

You can use a Commercial SSL certificate instead of the free Let's Encrypt certificate.

How to install a commercial SSL certificate

1. Obtain a certificate from a certificate authority for your domain.

2. Replace the server.crt and server.key files in /etc/nginx/ssl/ with the commercial certificate. Refer to your certificate vendor's documentation for details.

3. Reboot the server.

    # reboot

Certbot considerations

Certbot makes changes to the Nginx configuration. If you used certbot to obtain a Let's Encrypt certificate, return the Nginx configuration files to default before proceeding.

1. Back up your existing Nginx configuration files

    # cp -r /etc/nginx/ /root/nginx

2. Revoke your certbot certificate.

    # certbot delete

3. Restore the default Nginx configuration.

    # /opt/vultr/fix-vhost.sh

How to Disable HTTPS

Disabling HTTPS security is possible, but not recommended.

1. SSH to the server as root.

2. Move drupal_https.conf out of the Nginx configuration folder and reboot the server.

    # mv /etc/nginx/conf.d/drupal_https.conf /root/
    # reboot

About One-Click Apps

One-Click apps are updated regularly without notice. When launching a One-Click app, you'll receive our latest version. We do not update deployed instances, and you are responsible for keeping the instance up-to-date. If you design an infrastructure based on One-Click apps and need to ensure the same app version in the future, take a snapshot of the initial deployment and create new instances from the snapshot.