tamzi/klonq

How i deployed a ghost blog on heroku

This is a tutorial on how to Deploying a ghost blog on heroku.
Ghost is an Open Source application dedicated to content publishing. Ghost is built on Node.js.
This means you have to have node js installed. Its pretty straight forward. Head over to nodejs.org and check it out!

Documented steps to install below:

Created a repo on github.(This one..only had github's default readme when it started)
Headed over to ghost.org and downloaded Ghost(latest version)
Clone the repo you jsut created from github and unzip ghost in that folder and pretty much did an override on existing files(The README.md).
Head over to heroku -If you lack an account, create one and logIn.
Create an app.(On the dashboard)

Go to the deploy tab..url is probably sth like

# https://dashboard.heroku.com/apps/{YOUR USER NAME}/deploy

Then went to the github tab.{connect to gitHub}.
Scroll down to connect to github. and click on the connect to github. You will need to logIn to github to authorize heroku.
Next is for you to search for your github repo where you have ghost.
Search for the repo and click on it.
Then click connect.
I enabled Manual deploy. At the Manual deploy section, hit 'deploy branch' option.
Next is the settings option.I changed the name to match the same name that i use for the github repo.

NOTE: At this stage, the repo has been configured to deploy from github, but it will not display the post or blog but will give you an Application Error page from heroku. This is because, ghost has not yet been installed.

Setting Up Ghost.

Do a ghost install. You can check these out or run the following installs. Official Ghost Install Support for whichever env

Here are the install instructions:

How to install Ghost

 1. From the command line access the repo.
 2. Type
	 ```
		npm install --production
		```
 3. After install. We check whether Ghost installed correctly. run the command:
 ```bash
	npm start
```
> This will run ghost on **localhost:2368**
 4. After install. You need to stage the new files on github. open the command line and type
 ```bash
	$ git status
 ```

this will check the status of ghost.

 5. Because the new files that have been added are alot, we will do a
 	```bash
	$ git add -A
 ```
 This will add all the files in all the foleders that have been added, over 2000 new files by the way!

 6. Then commit the files locally by running the following command:
 	```bash
	$ git commit -m "{your commit message}"
 ```
 7. Then commit the files to your online repository on github.Do a :
 	```bash
	$ git push
 ```
 8.Yeay the online repo is now updated on github.

 > Though we have configured ghost to deploy manually from github, even though we do a manual deploy from heroku, nothing will be diplayed. We still have the same application error. This is because we have to configure ghost to tell it we are live and no longer local.

Making it go Live.

 1. Go to config.js file and look for these lines:
  - These lines:
 ```bash
 production: {
    url: 'http://127.0.0.1:2369', or 'http:localhost:2369',
	```
	 - change to:
	```bash
 production: {
    url: '{YOUR APP URL ON HEROKU} something like: https://klonq.herokuapp.com/',
	```


	- Then this one:
	```bash
	 server: {
        host: '127.0.0.1',
	 	port: '2368'
    }
	```
	need to change to:
	```bash
	 server: {
        host: '0.0.0.0',
		port: process.env.PORT
    }
	```

	- and this one:
	```bash
	 // Change this to your Ghost blog's published URL.
    url: '',
	```
	changes to:

 	```bash
	 // Change this to your Ghost blog's published URL.
    url: '{Your ghost url with https.tsh like: https://klonq.herokuapp.com/}',
 ```

- Save the changes. Commit the changes to github as we did above. steps number 4 to number 8
- Go to heroku dashboard. Do a manual deploy. In case you forgot:
	> 12. I enabled Manual deploy. At the **Manual deploy** section, hit **'deploy branch'** option.

Themes?

You can find themes here: All Ghost Themes
You can also make a theme:
Check this Ghost theme repo: klonqy to understand:
- how theming works
- how to install a ghost theme/template
- editing and creating a ghost theme

Questions?

Feel free any questions bugs and issues here: Ask questions here

Comming soon:

Theming in Ghost
Image handling with an external service
Configuring email to work

tamzi / klonq