This tutorial will be showing you how to install the Ghost blogging platform on the Ubuntu server. Ghost is an open-source blogging software coded in Node.js, allowing you to create modern, beautiful blogs. Compared to WordPress, Ghost is lightweight and much faster because it’s built specifically for blogging and isn’t a comprehensive content management system like WordPress.
The officially recommended production installation requires the following stack:
- Ubuntu 16.04, Ubuntu 18.04 or Ubuntu 20.04
- NGINX (minimum of 1.9.5 for SSL)
- A supported version of Node.js
- MySQL 5.7 or 8.0
- A server with at least 1GB memory
- A registered domain name
Before getting started you should set up a working DNS A-Record from you domain, pointing to the server’s IP address. This must be done in advance so that SSL can be configured during setup.
This part of the guide will ensure all prerequisites are met for installing the Ghost-CLI.
Create a new user
Open up your terminal and login to your new server as the root user:
# Login via SSH ssh root@your_server_ip # Create a new user and follow prompts adduser <user>
Note: Using the user name
ghostcauses conflicts with the Ghost-CLI, so it’s important to use an alternative name.
# Add user to superuser group to unlock admin privileges usermod -aG sudo <user> # Then log in as the new user su - <user>
Ensure package lists and installed packages are up to date.
# Update package lists sudo apt-get update # Update installed packages sudo apt-get upgrade
Follow any prompts to enter the password you just created in the previous step.
Ghost uses an NGINX server and the SSL configuration requires NGINX 1.9.5 or higher.
# Install NGINX sudo apt-get install nginx
ufw was activated, the firewall allows HTTP and HTTPS connections. Open Firewall:
sudo ufw allow 'Nginx Full'
Next, you’ll need to install MySQL to be used as the production database.
# Install MySQL sudo apt-get install mysql-server
MySQL on Ubuntu 18.04 or 20.04
If you’re running Ubuntu 18.04 or 20.04, a password is required to ensure MySQL is compatible with
Ghost-CLI. This requires a few extra steps!
# To set a password, run sudo mysql # Now update your user with this command # Replace 'password' with your password, but keep the quote marks! ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password'; # Then exit MySQL quit # and login to your Ubuntu user again su - <user>
You will need to have a supported version of Node installed system-wide in the manner described below. If you have a different setup, you may encounter problems.
# Add the NodeSource APT repository for Node 14 curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash # Install Node.js sudo apt-get install -y nodejs
Ghost-CLI is a command-line tool to help you get Ghost installed and configured for use, quickly and easily. The npm module can be installed with
sudo npm install ghost-cli@latest -g
Once installed, you can always run
ghost help to see a list of available commands.
Once your server is correctly setup and
ghost-cli is installed, you can install Ghost itself. The following steps are the recommended setup. If you need more fine-grained control, the CLI has flags and options that allow you to break down and customize the install steps.
Create a directory
Ghost must be installed in its own directory, with a proper owner and permissions.
# Create directory: Change `sitename` to whatever you like sudo mkdir -p /var/www/sitename # Set directory owner: Replace <user> with the name of your user sudo chown <user>:<user> /var/www/sitename # Set the correct permissions sudo chmod 775 /var/www/sitename # Then navigate into it cd /var/www/sitename
Run the install process
Now we install Ghost with one final command.
During install, the CLI will ask a number of questions to configure your site.
Enter the exact URL your publication will be available at and include the protocol for HTTP or HTTPS. For example,
https://example.com. If you use HTTPS, Ghost-CLI will offer to set up SSL for you. Using IP addresses will cause errors.
This determines where your MySQL database can be accessed from. When MySQL is installed on the same server, use
localhost (press Enter to use the default value). If MySQL is installed on another server, enter the name manually.
MySQL username / password
If you already have an existing MySQL database, enter the username. Otherwise, enter
root. Then supply the password for your user.
Ghost database name
Enter the name of your database. It will be automatically set up for you, unless you’re using a non-root MySQL user/pass. In that case the database must already exist and have the correct permissions.
Set up a ghost MySQL user? (Recommended)
If you provided your root MySQL user, Ghost-CLI can create a custom MySQL user that can only access/edit your new Ghost database and nothing else.
Set up NGINX? (Recommended)
Sets NGINX up automatically enabling your site to be viewed by the outside world. Setting up NGINX manually is possible, but why would you choose a hard life?
Set up SSL? (Recommended)
If you used an
https Blog URL and have already pointed your domain to the right place, Ghost-CLI can automatically set up SSL for you using Let’s Encrypt. Alternatively you do this later by running
ghost setup ssl at any time.
Enter your email
SSL certification setup requires an email address so that you can be kept informed if there is any issue with your certificate, including during renewal.
Set up systemd? (Recommended)
systemd is the recommended process manager tool to keep Ghost running smoothly. We recommend choosing
yes but it’s possible to set up your own process management.
yes runs Ghost, and makes your site work.