Installing Ghost & Getting Started

The first steps to setting up your new blog for the first time.

Troubleshooting & FAQ

'/usr/local/bin' doesn't appear in my $PATH
You can add it by doing the following:
  • In your terminal window type cd ~, this will take you to your home directory
  • Now type ls -al to show all the files and folders in this directory, including hidden ones
  • You should see a file called .profile or .bash_profile if not type touch .bash_profile to create a file
  • Next, type open -a Textedit .bash_profile to open the file with Textedit.
  • Add export PATH=$PATH:/usr/local/bin/ at the end of the file and save it
  • This new setting will get loaded when a new terminal starts, so open a new terminal tab or window and type echo $PATH to see that '/usr/local/bin/' is now present.
SQLite3 doesn't install

The SQLite3 package comes with pre-built binaries for the most common architectures. If you are using a less popular linux or other unix flavor, you may find that SQLite3 will give you a 404 as it cannot find a binary for your platform.

This can be fixed by forcing SQLite3 to compile. This will require python & gcc. Try it out by running npm install sqlite3 --build-from-source

If it won't build you're probably missing one of the python or gcc dependencies, on linux try running sudo npm install -g node-gyp, sudo apt-get install build-essential and sudo apt-get install python-software-properties python g++ make before retrying the build from source.

For more information about building the binaries please see: https://github.com/developmentseed/node-sqlite3/wiki/Binaries

Once you have successfully built a binary for your platform, please follow the instructions here to submit the binary to the node-sqlite project, so that future users won't have the same problem.

I can't upload images

If you're on a DigitalOcean Droplet setup when Ghost was at v0.3.2, or you're using nginx on some other platform, you may find you cannot upload images.

What's actually happening, is you cannot upload images bigger than 1MB (try a small image, it should work). That's a pretty small limit!

To increase the limit you need to edit your nginx config file, and set the limit to something else.

  • Log into your server, and type sudo nano /etc/nginx/conf.d/default.conf to open your config file.
  • After the server_name line, add the following: client_max_body_size 10M;
  • Finally, press ctrl + x to exit. Nano will ask you if you want to save, type y for yes, and press enter to save the file.