You are looking at the old Apostrophe 0.5 documentation. It is deprecated for new projects. Check out the latest version!

Running Apostrophe on Windows

← Previous: Achieving PCI compliance with Apostrophe

Thanks to Andrew Brown for this HOWTO.

Step 1: Install Software

For Apostrophe 2 to work on Windows you need to install:

  • Git
  • Node & NPM
  • MongoDB
  • Imagemagick (for image manipulation- required by Apostrophe)

To install git go to Git - Downloads and download the appropriate version. Be sure when asked about adjusting your path environment you select "Use Git from the Windows Command Prompt."

To install Node go to and click install. Keep all settings the same and it will also put node and npm into your environmental variables.

To install MongoDB go to Downloads - MongoDB and select the proper download for your computer. Be sure to select 32 or 64 bit depending on your system. Follow all of the prompts.

In your C: drive folder create a folder called "data". You can do that from the command prompt:

mkdir c:\data

This is where mongodb will store its database. Also be sure to place mongodb into your environmental variables.

Environmental variables are accessible by clicking:

Start Menu > right click "computer" > select "properties" > select "advanced system settings" from the left menu > select "environmental variables" from the bottom of the advanced tab > in the system variables section scroll down until you see the path variable > select path and click edit > add the location of the bin folder in your mongodb installation (i.e. mine is C:\Program Files\MongoDB 2.6 Standard\bin)

Click OK and close out of all windows.

NOTE: Ensure you separate distinct folders in the PATH with a semicolon.

Now when you type mongod at the command prompt you will start up your mongodb database. Be sure to leave that running.

To install Imagemagick go to: ImageMagick : Windows Downloads and download the latest version. Ensure that add environmental variables to system path is checked during the installation process.

Step 2

NOTE: Be aware of the differences in syntax between Mac OS and Windows terminals. cp translates to copy, rm to del, etc.

Otherwise, the tutorial provided by Apostrophe: Getting Started can be followed in Step 2.

NOTE: before you reset your database ensure that it is running by entering the command mongod at a shell prompt and leaving it running, if you have not already done this.

NOTE: If running node app gives you an error that relates to EPERM and permissions, a quick fix is to run the cmd prompt as an admin user and these should go away.

Step 3

This can also be closely follows as stated in the getting started guide but note that rm -rf .git means del .git for windows users.

Hope this helps and gets you started with Apostrophe development on windows.

Next: Migrating from A2 Version 0.4 →