Deploy ghost on a PaaS

Quick tutorial to deploy Ghost.org instance on Clever Cloud:

UPDATE: This article is a little bit old, but some users decided to write a more recent documentation here on how to deploy a Ghost blog on Clever Cloud

ghost logo

1. Retrieve Ghost files

In order to download Ghost files, just visit this page : https://en.ghost.org/download/

Extract the file and put the folder in your favorite place.

2. Open an account on Clever Cloud

Just visit the signup page and follow the steps.

3. Create an application

Add a Node.js application.

More information available in our documentation : http://doc.clever-cloud.com/clever-cloud-overview/add-application/

4. Create a File System Bucket

Let’s store the data!

When you deploy an application, a new instance is created. If you do not persist content files like articles and images, you will lose them between two deployments.

In order to store these files, we have created FS (File System) buckets.

Just add one in the services section.

More information can be found in our documentation : https://doc.clever-cloud.com/databases-and-services/fs-buckets/

You will receive the credentials by email. At the root of the application, create a clevercloud/buckets.json file with the following structure:

[
  {
    "bucket" : "bucketId",
    "folder" : "/content"
  }
]

It tells the application to use the files located in the content directory in the FS Bucket.

With the FTP credentials, upload the files located in your local content folder to the remote FTP folder. At the root of the FTP folder, you should have /data, /images, etc. folders.

5. Ghost Configuration

You have to tell Ghost how you would like to use it by editing the /config.js.

In both development and production sections:

  • change host to 0.0.0.0
  • change port to 8080

6. Deploy the application

Last operation, push the local files to the cloud!

Deploy your application on Clever Cloud is very easy. Just type the following commands:

  • init the git repository : git init
  • create a .gitignore file like this:
node_modules
content
  • add all files: git add .
  • commit: git commit -m firstcommit
  • push to Clever Cloud: git push <ccremoteurl> master

You can then check the logs in the left panel logs section.

Not happy with SQLite? Go MySQL

If you do not want to deal with SQLite storage, you can store your data in MySQL.

To do this, replace the following section:

database: {
  client: 'sqlite3',
  connection: {
    filename: path.join(__dirname, '/content/data/ghost-test.db')
  }
}

with:

database: {
  client: 'mysql',
  connection: {
    host: 'yourhostname',
    user: 'yourusername',
    password: 'yourpassword',
    database: 'yourdbname',
    charset: 'utf8'
  }
}

You can create a MySQL database on Clever Cloud in 5 seconds.

Want to send emails?

Ghost require external mail providers so that you can send emails. Some of them are Mailjet, Mailchimp, Mailgun or Gmail.

The following example allow you to send emails with your Gmail/Google Apps accound from Ghost :

mail: {
  transport: 'SMTP',
  fromaddress: 'myemail@address.com',
  options: {
    auth: {
      user: 'youremail@gmail.com',
      pass: 'yourpassword'
    }
  }
}

Feel free to ask us if you have any questions about this article.

Blog

À lire également

CollabNext: A sovereign alternative to US office suites and clouds

At a time when digital sovereignty is becoming a priority for European organisations, the CollabNext project is emerging as a bold response.
Press

Clever Cloud announces 11 new products at its Clever Cloud Fest

Clever Cloud is celebrating its 15th anniversary with the Clever Cloud Fest on 6 and 7 February 2025 in Nantes. This event will bring together customers and partners, during which Clever Cloud will unveil 11 new products and an international growth strategy.
Company Event Press

What is Clever AI?

AI services are everywhere, but the sheer number and diversity of them makes it harder for developers to manage them. All the more so when they work in a team. That's why we came up with Clever AI: a multi-vendor, multi-model range of solutions to simplify access to AI for businesses.
Company