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
- Download and install Docker (or Docker Desktop)
- Instructions for your given platform can be found on Docker's site.
- 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.
- Open a terminal and type
- Download a dotCMS docker-compose example .yml file.
- These examples are taken from the dotCMS Docker Github repo to download docker-compose.yml examples for:
- An Empty dotCMS instance.
- A Demo dotCMS instance (with the full dotCMS starter site, like the dotCMS Demo Site).
- These examples are taken from the dotCMS Docker Github repo to download docker-compose.yml examples for:
- 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
- You will know that the server has started up when you see message like this in the log files:
- These docker compose examples use an externalized Elasticsearch (open distro) server and a Postgres database.
- Any errors will be reported in the
dotcms.logfile.- 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 downbefore the restart.
- This will stop the Docker image, but if you wish to restart the image, you will also need to run
- 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:
- Enter the address
http://localhost:8080/dotAdmininto your browser. - Login using the following credentials:
User: admin@dotcms.comPassword: admin