One-Click Magento
Introduction
Vultr's One-Click Magento application is a ready-to-run eCommerce platform running Magento Community Edition on Ubuntu server. Select a server location, choose your instance size, and click Deploy Now. Your server will be ready to configure in about a minute. Magento requires a Vultr instance with at least 1 GB of RAM. Magento runs on the Ubuntu Server LTS operating system.
1. Install SSL Certificate
This step is optional, but recommended. Most Magento 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. See our instructions to bypass the HTTPS warning for self-signed SSL/TLS certificates.
- Proceed past the warning to complete setup.
To install a free Let's Encrypt SSL certificate:
Register the name and create a DNS record for the server's IP address. Consult your DNS provider for instructions, or see our guide if using Vultr's DNS.
Verify the 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.
Connect to your server, with the root login from the Server Information screen.
Install certbot and the Nginx plugin to manage the Let's Encrypt certificate.
Set the server_name for Nginx. Edit /etc/nginx/conf.d/magento_https.conf:
Change the underscore in the line "server_name _;" to your server domain name. This appears near the top of the file. For example:
Save and exit the file.
Install the certificate with certbot. Replace the domain name and email with your values.
Certbot should report success when finished.
2. Configure Magento Base URL
When first installed, Magento uses the IP address as the base URL. This step changes the base URL to the domain name. You will encounter a certificate warning for your first admin login because Magento redirects your browser to the IP address.
Navigate to the admin area of your store. For example:
Proceed past the certificate warning.
Log in to Magento with the Admin user.
Navigate to Stores > Configuration.
Navigate to Web > Base URLs. Make two changes:
- Change the Base URL to your server domain name.
- Change the Base URLs (Secure) to your server domain name.
Click Save Config. Magento will log you out and redirect you to log in again, this time at the server domain name.
Magento will display a warning that the cache needs to be flushed. Follow the link and clear Magento's cache.
Verify that the certificate in your browser is valid.
More Information
MySQL
A MySQL database is running on your VPS for Magento. If you need to access the database directly:
Connect to the server via ssh as root.
Log into MySQL.
The MySQL root password is saved in
/root/.my.cnf.
XHProf Performance Analysis
Access your XHProf installation at https://oneclick.example.com/xhprof/xhprof_html/. You'll find the username and password on your Server Information page.
PHPMyAdmin Database Manager
Access your PHPMyAdmin installation at https://oneclick.example.com/mysqladmin/. You'll find the username and password on your Server Information page.
Cockpit Control Panel
Access your Cockpit a control panel at https://oneclick.example.com:9080. You'll find the username and password on your Server Information page.
Disable Cockpit
If you need to disable Cockpit, SSH to the server as root and run the following command:
Vultr Helper Scripts
Vultr provides helper scripts for common issues. SSH to the server as root to run these scripts.
Reset Nginx
If Nginx fails to load, you may have a typo or corruption in your configuration files. The fix-vhost.sh script will reset the Nginx configuration to default.
Check Software Versions
For debugging purposes, our support team may ask for your Magento and Ubuntu versions. Run the version.sh script.
Commercial SSL
You can use a Commercial SSL certificate instead of the free Let's Encrypt certificate.
How to install a commercial SSL certificate
Obtain a certificate from a certificate authority for your domain.
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.
Reboot the server.
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 installing the commercial certificate.
Back up your existing Nginx configuration files
Revoke your certbot certificate.
Restore the default Nginx configuration.
Directories of Interest
Magento is installed at: /var/www/html
Update Bug
This issue was corrected in February 2016.
Magento 2.1.3 failed to include a link to the updater in the admin panel. You can navigate to the updater manually with the following link. Replace the parts in caps accordingly.
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.
0 Comments
Be the first to comment and share your perspective with the community.