Quick Start Guide documentation for the dotCMS Content Management System

You can quickly setup and install the dotCMS starter site using the standard dotCMS Docker images.

Important
This process is intended for EVALUATION and DEVELOPMENT only.

Installation Steps

  1. Download and install Docker (or Docker Desktop)
    • Instructions for your given platform can be found on Docker's site.
  2. Ensure that you have docker-compose installed.
    • Open a terminal and type docker-compose.
    • For more information, or if you would like more information on the messages you receive, please see the Docker Compose documentation.
  3. Download a dotCMS docker-compose example .yml file.
  4. Use the following one-line command to download and run dotCMS in Docker:
    wget -O docker-compose.yml https://dotcms.com/run/demo && docker-compose up
    

Important Notes

  • If you are loading the full starter site, dotCMS may take 5 minutes or more to startup the first time.
    • You will know that the server has started up when you see message like this in the log files:
      20-May-20XX 17:41:24.463 INFO [main] org.apache.catalina.startup.Catalina.start Server startup in 157516 ms
      
  • These docker compose examples use an externalized Elasticsearch (open distro) server and a Postgres database.
  • Any errors will be reported in the dotcms.log file.
    • If you are unable to start dotCMS and need assistance, please include this log file with your request.
  • To stop the Docker image, hit crtl+C in the console where you started the image.
    • This will stop the Docker image, but if you wish to restart the image, you will also need to run docker-compose down before the restart.
  • To run the Docker image in the backgroud (and tail the logs), run:
    docker-compose down && docker-compose up -d && docker-compose logs -f
    

Accessing the Docker Image Site

To view the front-end of the dotCMS site, enter the following address in your browser:

http://localhost:8080/

To login to the Admin console on the starter site:

  1. Enter the address http://localhost:8080/dotAdmin into your browser.
  2. Login using the following credentials:
    User:admin@dotcms.com
    Password:admin