OpenShift Quickstart has been updated to v0.3.3

Ghost

Ghost is a free, open, simple blogging platform that's available to anyone who wants to use it. Lovingly created and maintained by John O'Nolan + Hannah Wolfe + an amazing group of contributors.

Visit the project's website at http://ghost.org!

Running Ghost on OpenShift

This is a basic quickstart to get Ghost running on OpenShift.

If you have already created an application with this, and are having issues with it not working when you do a restart, run this command, then issue a restart and it should be fixed.

rhc set-env NODE_ENV=production --app $appname

Where $appname is the name of your application. This was due to the pre_start_nodejs-0.10 script not running on a restart.

The easiest way is to use the following command, make sure that you run 'gem update rhc' first so that you have the newest version:

rhc app create ghost nodejs-0.10 mysql-5.1 --env NODE_ENV=production --from-code https://github.com/developercorey/openshift-ghost-mysql-quickstart.git

'ghost' will be the name of your application.

Note these OpenShift specific changes:

1. The content/data and content/images directories have been removed. They are created on the server and symlinked to your $OPENSHIFT_DATA_DIR so that posts and uploaded images will persist across 'git pushes'
2. Even though the node.js cartridge itself is scalable, this application will not play nice with scaling right now because it is using sqlite3 as the database (which is a file store), and the images are stored on disk, and since OpenShift does not currently support shared physical disk storage across scaled gears, this cartridge will not scale. We are working on a solution for this.
3. This quickstart currently is not setup for using MySQL, but it may be updated in the future, or another quickstart provided. That will eliminate one of the scaling concerns.

Getting Started

There are two main ways to get started with Ghost:

1. Working from a Release - these are pre-built zip packages found on ghost.org. Installation instructions are below.
2. Working from the GitHub repo - instructions can be found in CONTRIBUTING.md

Installing from a Release

Please Note: Releases are pre-built packages, GitHub releases (tags) are not. To install from GitHub you need to follow the contributing guide.

1. Once you've downloaded one of the releases, unzip it, and place the directory wherever you would like to run the code
2. Fire up a terminal (or node command prompt in Windows) and change directory to the root of the Ghost application (where config.example.js and index.js are)
3. run npm install --production to install the node dependencies
4. To start ghost, run npm start
5. Visit http://localhost:2368/ in your web browser

Updating with the latest changes

Warning: The Ghost file system contains your database and config. Be sure to back these up first.

1. Make a backup of your data!
2. Update the files by pasting new files over the top of old ones. If prompted by your OS or FTP client to 'merge' or 'replace' always choose 'merge'.
3. Run npm install
4. Run npm update
5. Restart the application
6. Log out and log back in again.

Logging in For The First Time

Once you have the Ghost server up and running, you should be able to navigate to http://localhost:2368/ghost/ from a web browser, where you will be prompted for a login.

1. Click on the "register new user" link
2. Enter your user details (careful here: There is no password reset yet!)
3. Return to the login screen and use those details to log in.

Note - this is still very alpha. Not everything works yet.

Versioning

For transparency and insight into our release cycle, and for striving to maintain backward compatibility, Ghost will be maintained according to the Semantic Versioning guidelines as much as possible.

Releases will be numbered with the following format:

<major>.<minor>.<patch>-<build>

Constructed with the following guidelines:

• A new major release indicates a large change where backwards compatibility is broken.
• A new minor release indicates a normal change that maintains backwards compatibility.
• A new patch release indicates a bugfix or small change which does not affect compatibility.
• A new build release indicates this is a pre-release of the version.

Reporting Bugs and Contributing Code

Want to report a bug, request a feature, or help us build Ghost? Check out our in depth guide to Contributing to Ghost. We need all the help we can get!

Community

Keep track of Ghost development and Ghost community activity.

• Follow Ghost on Twitter, Facebook and Google+.
• Read and subscribe to the The Official Ghost Blog.
• Chat with Ghost developers on IRC. We're on irc.freenode.net, in the #Ghost channel.

Copyright & License

Copyright (C) 2013 The Ghost Foundation - Released under the MIT Lincense.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.