Skip to content

Latest commit

 

History

History
46 lines (29 loc) · 3.74 KB

install.md

File metadata and controls

46 lines (29 loc) · 3.74 KB

Installing Calypso

You can install Calypso directly on your machine by following the next steps, or use a portable development environment:

Quick Summary of Steps

  1. Check that you have all prerequisites (Git, Node, NPM). See below for more details.
  2. Clone this repository locally.
  3. Add 127.0.0.1 calypso.localhost to your local hosts file.
  4. Run npm install
  5. Execute make run or make dashboard (for a more visually-oriented interface) from the root directory of the repository.
  6. Open calypso.localhost:3000 in your browser.

Prerequisites

On Mac OS X or Linux, to be able to clone the repository and run the application you need:

  • Install the Node.js and matching NPM versions listed in the engines section of package.json. On Mac OS X using nvm or n makes it easy to manage node versions.
  • Git. Try the git command from your terminal, if it's not found then use this installer.
  • The repository also uses make to orchestrate compiling the JavaScript, running the server, and several other tasks. On Mac OS X, the easiest way to install make is through Apple's Command Line Tools for Xcode (requires free registration).

On Windows, you can follow these setup steps to install the prerequisites.

Installing and Running

Clone this git repository to your machine via the terminal using the git clone command and then run make run from the root Calypso directory:

$ git clone https://github.com/Automattic/wp-calypso.git
$ cd wp-calypso
$ make run

The make run command will install any npm dependencies and start the development server. When changes are made to either the JavaScript files or the Sass stylesheets, the build process will run automatically. The build process compiles both the JavaScript and CSS to make sure that you have the latest versions of both.

To run Calypso locally, you'll need to add 127.0.0.1 calypso.localhost to your hosts file, and load the app at http://calypso.localhost:3000 instead of just localhost. This is necessary, because when running locally Calypso is using the remote version of the WordPress.com REST API, which allows only certain origins via our current authentication methods.

See Development Workflow for more.

Starting the node debugger

The make run command will pass anything set in the NODE_ARGS environment variable as an option to the Node command. This means that if you want to start up the debugger on a specific port you can run NODE_ARGS="--debug=5858" make run. Starting the built-in inspector can also by done by running NODE_ARGS="--inspect" make run. In either case, if you would like to debug the build process as well, it might be convenient to have the inspector break on the first line and wait for you. In that case, you should also pass in the --debug-brk option like so NODE_ARGS="--inspect --debug-brk" make run.

Using a portable development environment

You can install Calypso very quickly via a portable development environment called Calypso Bootstrap. It uses Vagrant and Puppet behind the scenes to install and configure a virtual machine with Calypso ready to run - with a single command.