The dotCMS distribution comes with a “pre-built” starter site which includes a complete sample site demonstrating the capabilities of dotCMS and providing samples of almost all content types and assets (including Folders, Pages, Content Types, Templates, Containers, code, and more).
This starter site data is contained in the
starter.zip file. This file can be found in the
webapps/ROOT directory in the dotCMS distribution (
_/dotserver/tomcat-X.x.xx/webapps/ROOT_). When dotCMS is started, it checks to see if a working site has already been set up; if the database and assets are empty, dotCMS will import any data found in the
- Starting with an empty site
- Creating a Custom Starter Site
- Important Notes
Starting with a empty site
If you want to start building in dotCMS from a blank slate, you can download our “empty starter”. The canoncal versions of these empty starters can be found in our artifactory repo, here: dotCMS Starters.
Creating a Custom Starter Site
You may replace the default dotCMS starter site with a custom starter site. This enables you to quickly deploy custom starter sites/accelerators on a new dotCMS instance with a specific set of customized pre-built features, content types, assets, etc.
Creating a Custom starter.zip File
starter.zip file can be created using the built-in Export dotCMS Content function in dotCMS.
To create a custom
- Build up a normal dotCMS instance containing all the content to include in the custom starter site.
- Note: All content included in this dotCMS instance will be included in the custom starter site, including all sites, content types, content, etc. Make sure that this dotCMS instance only includes content that you want to include in your starter site.
- From the backend of your dotCMS instance, select System -> Maintenance and click the Tools tab.
- In the Export dotCMS Content section of the Tools tab, press the Download Data/Assets button.
- This will download a ZIP file containing all content on the dotCMS instance.
- Rename the downloaded ZIP file to
Deploying a Custom Starter Site
To configure a new dotCMS instance to point to a custom starter site:
- (Recommended) Disable the default
- Create a new static plugin to contain and deploy your custom starter site.
- Create a dotmarketing-config-ext.properties properties extension file in the plugin /conf directory (e.g. /plugins/plugin.name/conf).
- Add the
STARTER_DATA_LOADproperty to the properties extension file and set it to a relative path from the root of the dotCMS distribution, as in the following example:
- Deploy the plugin.
When the new dotCMS instance is started (with a clean database and cache), dotCMS will create a new dotCMS instance using your custom starter site.
- It is important that you perform all the above steps before starting your dotCMS instance the first time.
- If you start the dotCMS instance before deploying your starter site plugin, the default dotCMS starter site will be installed; if you later start dotCMS after deploying your plugin, your custom starter site will not be installed, since an existing site (the default starter site) will already exist.
- As a best practice, it is recommended that you keep your custom
starter.zipfile in the same plugin used to set the
- This allows you to easily copy and deploy the entire plugin to new dotCMS distributions.
- The dotCMS Demo Site is built using the default starter site.
- This means that even if you have not installed the default starter site on your local dotCMS distribution, you can view and copy contents from the default starter site by browsing the back-end of the dotCMS demo site.
- The dotCMS demo site is rebuilt (and all changes are wiped out) at 12pm and 12am EST every day, to restore the demo site to the default configuration.
- The default starter site login credentials (both when installed locally or on the dotCMS Demo Site) are: