FirePress.org | play-with-ghost | GitHub | Twitter

ghostfire

What is this?

Docker image — This is a Docker image to run Ghost (v 2.x.x) in a container 🐳. Fully compatible with a simple docker run, Docker Swarm or Kubernetes. Ensure you have Docker installed on your machine.

What is Ghost? — Ghost is an open source software that lets you create your website with a blog. See the FAQ section for more details.

Why forking the official Docker image?

Overall, I do my best to apply best practices. Please let me know if something can be improved :)

Comparing docker image sizes

multi-stage / using my node-core
devmtl/ghostfire:2.23.4-77c5e56                 201 MB (74 MO)

multi-stage / simply using node_10.16-alpine
devmtl/ghostfire:2.23.3-bf541c7                 246 MB (79 MO)

single-stage docker official
ghost:alpine  / simply using node_10.16-alpine  284MB (123 MB)

Live Demo

Want to try Ghost quickly? This is for you!

play-with-ghost.com is a playground to learn about Ghost. What's remarkable here, is that you have the option to log into the admin panel of each live demo available, by using dummy credentials.

In short, you can try Ghost on the spot without having to sign-up!

How to use this docker image?

First, find the latest docker images tags 🐳.

Docker hub

Find the latest tags here: https://hub.docker.com/r/devmtl/ghostfire/tags/

Travis CI

https://travis-ci.org/firepress-org/ghostfire

At this point, this docker image has been pulled more than 11 millions of time!

Option #1 (let the script work for you):

Run the script by typing: ./runup.sh

Option #2:

GHOSTFIRE_IMG="devmtl/ghostfire:2.23.4-77c5e56"

docker run -d \
—name ghostblog \
-p 2368:2368 \
-e url=http://localhost:2368 \
${GHOSTFIRE_IMG}

Option #3 (Stateful with configs):

GHOSTFIRE_IMG="devmtl/ghostfire:2.23.4-77c5e56"

docker run -d \
—name ghostblog \
-p 2368:2368 \
-e url=http://localhost:2368 \
-v /myuser/localpath/ghost/content:/var/lib/ghost/content \
-v /myuser/localpath/ghost/content:/var/lib/ghost/config.production.json \
${GHOSTFIRE_IMG}

To configure the config.production.json refer the ghost docs.

master branch (stable) tags 🐳

For the stable branch, I recommend using the tag from the first line:

devmtl/ghostfire:2.23.4-77c5e56 (best practice)
devmtl/ghostfire:2.23.4
devmtl/ghostfire:stable

edge branch (dev) tags 🐳

For the edge branch (for dev), I recommend using the tag from the last line:

devmtl/ghostfire:edge-2.23.4-7d64db0
devmtl/ghostfire:edge-2.23.4
devmtl/ghostfire:edge

DevOps best practices

⚠️ Workflow warning. You would expect that we would merge edge into master. We don’t do this. Instead, think of it as independent projects. The main reason is that the .travis.yml is not the same in those two branches.

Let's understand our processes.

Because we run a lot of websites in production using this image, we prefer to do UAT (unit acceptance tests) using the edge branch. In other words, it’s a manual checkpoint to avoid a crash at scale. DevOps best practices are essential to us. Many checkpoints ensure this Docker image for Ghost software runs smoothly.

It also has the advantage of keeping a clean commit history in the master branch (without doing git-fu all the time).

In this post « How we update hundreds of Ghost's websites on Docker Swarm? », we explain how we deploy Ghost in production and which best practices we do follow.

Enhanced unit tests (screen shots from Travis CI)

Developing Ghost themes locally

I open sourced my setup here. It’s a workflow to run Ghost locally within a Docker container. Once your local paths are defined, it’s enjoyable and easy to work between many themes.

Random stuff

Breaking change. If you still run Ghost 0.11.xx (not recommanded!), be aware of the container's path difference.

- Ghost 2.x.x is: /var/lib/ghost/content
- Ghost 1.x.x is: /var/lib/ghost/content
- Ghost 0.11.x is: /var/lib/ghost

SQLite Database

This Docker image for Ghost uses SQLite. There is nothing special to configure.

What is the Node.js version?

We follow the latest Node supported version. See this in the Dockerfile.

docker exec <container-id> node --version

You can also see this information in the Travis CI logs.

FirePress Hosting

At FirePress we empower entrepreneurs and small organizations to create their websites on top of Ghost.

At the moment, our pricing for hosting one Ghost website is $15 (Canadian dollars). This price will be only available for our first 100 new clients, starting May 1st, 2019 🙌. See our pricing section for details.

More details about this annoucement on Ghost's forum.

Contributing

The power of communities pull request and forks means that 1 + 1 = 3. You can help to make this repo a better one! Here is how:

Fork it
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request

Check this post for more details: Contributing to our Github project. Also, by contributing you agree to the Contributor Code of Conduct on GitHub. It's plain common sense really.

License

This git repo is under the GNU V3 license. Find it here.
The Ghost’s software is under the MIT license. Find it here.

Sources & Fork

This Git repo is available at https://github.com/firepress-org/ghostfire
Forked from the official Ghost image

Why all this work?

Our mission is to empower freelancers and small organizations to build an outstanding mobile-first website.

Because we believe your website should speak up in your name, we consider our mission completed once your site has become your impresario.

For more info about the man behind the startup, check out my now page. You can also follow me on Twitter @askpascalandy.

— The FirePress Team 🔥📰

License

stackriot-labs/ghostfire

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages