Skip to content

Quick Start Guide

Follow this guide to run the WebSight CMS local instance using Docker. You can use it to review our demo site Luna. You can use Howlite, our example components library, to create or update pages too.

If you want to develop custom components for WebSight CMS, complete this guide to learn foundations first. Then, read more details in quick start for developers.

Prerequisites

Before going any further, please make sure you have Docker Desktop installed on your machine and running.

Part A: Run local instance using Docker

Quick setup with curl

If you have curl installed, you can set up the local environment using the following command. Then, you can go directly to Part B below.

curl https://www.websight.io/scripts/get.sh | sh

1. Create Docker Compose manifest

Create docker-compose.yml file. Paste the content presented below and save the file on your hard drive.

docker-compose.yml
version: "3.9"

services:
  cms:
    image: public.ecr.aws/ds/websight-cms-ce:luna-2.1.2
    ports:
      - "8080:8080"
    environment:
      WS_ADMIN_USERNAME: "wsadmin"
      MONGODB_HOST: "mongo"
      MONGODB_PORT: 27017
      LEASE_CHECK_MODE: "LENIENT"
    volumes:
      - cms_logs:/websight/logs
      - site_repository:/websight/docroot
    depends_on:
      - mongo
  nginx:
    image: public.ecr.aws/ds/websight-nginx-ce:luna-2.1.2
    ports:
      - "80:80"
    volumes:
      - site_repository:/usr/share/nginx/html:ro
  mongo:
    image: mongo:4.4.6
    environment:
      - MONGO_INITDB_ROOT_USERNAME=mongoadmin
      - MONGO_INITDB_ROOT_PASSWORD=mongoadmin
    volumes:
      - mongo_repository:/data/db

volumes:
  cms_logs:
  mongo_repository:
  site_repository:

Tip

Default passwords are stored in secret files. You can find details how to change them here.


2. Run the local instance

Open the terminal next to the docker-compose.yml file and run the following command:

docker compose up

The fresh WebSight instance will start in a couple of seconds. Now, you may enter http://localhost:8080/ to open the WebSight admin panel. Log in with wsadmin username and wsadmin as a password.

Tip

To stop the environment use ctrl + c. You may run it later exactly the same as it was started for the first time.


Part B: Publish demo site

Your local environment is running now. The next step is to publish a demo site included in the distribution.

1. Open the Websight admin panel

The WebSight admin panel runs at http://localhost:8080/. Log in with wsadmin username and wsadmin as a password.

2. Select space for the demo site

We use Spaces to organise content. Please open the space for the demo site Luna.

Spaces

3. Publish assets and the demo site

Open list of Assets using the left sidebar. Go to folder images, select all subfolders and use action Publish.

Assets publication

Open list of Pages using the left sidebar. Select all pages and use action Publish.

Pages publication

4. See the demo site

Congratulations! The demo site is available at http://luna.127.0.0.1.nip.io/.

Published demo page

Part C: Update a page

Now that your local demo site is published, we would like to guide you through basic page amendments. You will update the home page for the demo site delivered together with the WebSight.

1. Open the Websight admin panel

The WebSight admin panel runs at http://localhost:8080/. Log in with wsadmin username and wsadmin as a password.

2. Select space for the demo site

We use Spaces to organise content. Please open the space for the demo site Luna.

Spaces

3. Edit the home page

Use Pencil icon to open Page editor for the home page.

Actions available for a page

Scroll down the content to section Custom Made Engagement Rings.

Page section to be updated

Find Rich text editor on tab Components and use drag & drop to place it just below the section title.

Rich text editor available in component tree

Click on the new component to open available actions. Select Pencil icon to edit properties.

Actions available for RTE component

Copy & paste the following text on General tab of the modal.

Every couple is unique and we want to deliver an engagement ring that is unique too – taking the tastes of the couple into account. We love having couples visit the store and work with them to create a unique custom engagement ring according to their tastes.

RTE component properties

4. Publish changes

You updated the page. However, unpublished changes are not visible on the site yet. In the top right corner, open the dropdown and select action Publish.

Publish page action

5. See the updated page

Congratulations! Your changes should be visible now at http://luna.127.0.0.1.nip.io/.

Publish page action

The next steps

You learned the foundation of page editing with WebSight CMS. Now, we encourage you to explore more details: