Local development with CEO

First, you'll need a few things:

  • Docker
  • Access to our private CEO Docker image

Docker is a free download, you will need to contact support for the CEO Docker image.

Using our helper tool, XO, you can easily boot and interact with your CEO Docker image.

  1. First, install XO by opening terminal and navigating to your template repository. Then paste in the following command and hit return:
    curl -s https://s3.amazonaws.com/static.getsnworks.com/local-dev/setup.sh | /bin/bash
  2. Your site's settings will be in the xo.yaml file that's created by the setup command. By default it will create your development site at http://localhost:8080, but if you want it at a different port, you can change it here.
  3. To verify that xo wasn't altered in transit, you can verify its hash by typing:
    md5 xo The hash should match:
    0ab2714a75484095aec26a9f2802ff79
  4. After that, to create the Docker image enter:
    ./xo build
  5. And to start it:
    ./xo up
  6. If you don't have a database dump handy, grab your developer export, drop it into your site's root folder and run:
    ./xo fresh-start

To stop Docker when you're done, type:

./xo down


With Docker running you can run CEO commands for tasks like adding content to the database, simulating the production environment and other interactions with the headless CEO application.

Running CEO commands is as easy as:

./xo run COMMAND

CEO commands list