Set up development environment

This guide will walk you through setting up a development environment for Blot. Follow these steps to run the server locally and start working on your blog.

1. Install Docker

You will need Docker. Ensure that Docker is installed and running on your machine before proceeding.

2. Clone the Repository

Use Git to clone Blot’s source code to your machine:

$ git clone https://github.com/davidmerfield/blot

3. Start the Server

Navigate to the cloned repository and start the server:

$ npm start

4. Add SSL Exceptions

Before you begin working on the code, open the following URLs in your browser and add an exception for the self-signed SSL certificates:

• https://localhost/
• https://cdn.localhost/
• https://example.localhost/

5. Access the Dashboard and Example Site

Once you have trusted the self-signed certificates, you can access the following:

• The dashboard: https://localhost
• The example site: https://example.localhost

6. Edit the Example Blog

The folder for the example blog is located inside the data directory. You can edit it here:

./data/blogs/blog_$ID