--- url: 'https://dxpr.com/hc/documentation/learn-dxpr-builder/getting-started/installing-dxpr-cms' title: 'Start a new site with DXPR CMS | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2023-11-06T09:42:49+00:00' updated: '2026-10-23T14:31:17+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: 'The fastest start, a distribution with the builder, theme and content types preconfigured' tags: - 'Install and update' image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' published: true og: site_name: DXPR updated_time: '2026-10-23T14:31:17+0000' 'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.' schema: '@context': 'https://schema.org' '@graph': - mainEntity: { } - '@type': TechArticle headline: 'Start a new site with DXPR CMS' description: 'The fastest start, a distribution with the builder, theme and content types preconfigured' image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2023-11-06T09:42:49+0000' dateModified: '2026-10-23T14:31:17+0000' author: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' mainEntityOfPage: 'https://dxpr.com/hc/documentation/learn-dxpr-builder/getting-started/installing-dxpr-cms' articleSection: 'Install and update' - '@type': WebPage '@id': 'https://dxpr.com/hc/documentation/learn-dxpr-builder/getting-started/installing-dxpr-cms' description: 'The fastest start, a distribution with the builder, theme and content types preconfigured' breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: Home item: 'https://dxpr.com/' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: en --- [Help Center](/hc)/[Documentation](/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Start here](/hc/documentation/learn-dxpr-builder/start-here) /[Install and update](/hc/documentation/learn-dxpr-builder/start-here/install) # Start a new site with DXPR CMS. The fastest start, a distribution with the builder, theme and content types preconfigured Learn DXPR BuilderStart hereInstall and update ## In this guide Related guides - [Your first page](/hc/documentation/learn-dxpr-builder/getting-started/first-page) - [Installing the demo content](/hc/documentation/learn-dxpr-builder/getting-started/installing-simple-demo) - [User profiles](/hc/documentation/learn-dxpr-builder/admin/user-profiles-admin) DXPR CMS is a Drupal distribution with DXPR Builder, DXPR Theme, content types, demo pages and AI modules already set up. Install it when you start a new site. For a site you already run, [install DXPR Builder on its own](/hc/documentation/learn-dxpr-builder/getting-started/installation) instead. At the end you log in to a working site whose home page you edit in the builder. ## Before you start - PHP 8.3 or later, which Drupal 11 needs, plus Composer, Git and a database. The project includes a [DDEV](https://ddev.com/)configuration; any Drupal 11 hosting works too. - Your product key from [app.dxpr.com/getting-started](https://app.dxpr.com/getting-started). The installer calls it the **DXPR API Key**. ## What is included - **DXPR Builder**, with the **Drag and Drop Block** block type - **DXPR Theme**, a Bootstrap 5 theme with settings for colours, fonts, header and layout - The **Basic page**, **Blog post** and **Landing Page** content types, all set to the builder - Demo pages: **Home**, **Page** and **Contact Us** - The AI module and the DXPR AI Provider, for AI text, pages and images During installation you can pick extra add-ons. They are **Case Studies**, **Events**, **Forms**, **Google Analytics**, **News**, **SEO Tools** and **Multilingual**. ## Download DXPR CMS 1. Clone the project: ```bash git clone https://github.com/dxpr/dxpr_cms.git my-site cd my-site ``` 2. Download Drupal core and the modules: ```bash composer install ``` With DDEV, run `ddev start` first and put `ddev` before each `composer`and `drush` command. ## Install in the browser 1. Open the site in your browser. The DXPR CMS installer starts on its own. 2. Answer its questions, such as which optional add-ons to install. 3. On **Activate AI Features**, paste your product key into **DXPR API Key**, or click **Skip this step**. ## Install from the command line Instead of the browser, you can install with Drush. Replace the database details and the key with your own: ```bash drush site:install dxpr_cms_installer \ --db-url=mysql://user:pass@localhost/dbname \ dxpr_cms_installer_keys.dxpr_key='YOUR_PRODUCT_KEY' -y ``` To add optional add-ons, append `"installer_recipes_form.add_ons=Events|News"`, or use `*` for all of them. Drush prints the administrator's login details when it finishes. ## What you see The installer ends on the home page, `/home`. Log in as the administrator and the builder controls appear on its content. The **Home**, **Page** and **Contact Us** pages are ordinary content: edit, unpublish or delete them under **Content**. | | DXPR CMS | DXPR Builder on its own | |---|---|---| | Starting point | A new site | A Drupal site you already run | | Theme | DXPR Theme | Any theme | | Demo pages | Home, Page and Contact Us | None | | Content types | Set to the builder | You set the formatter yourself | ## If you don't see the builder - **The home page shows no builder controls.** You are not logged in, or your role lacks **Edit with DXPR Builder**. DXPR CMS grants it to the content administrator, site builder and content editor roles; assign one at **People**. - **The AI prompt is greyed out and says no AI provider is configured.** You skipped the key during installation. Add it under **License** at `/admin/dxpr_studio/dxpr_builder/settings` and under **DXPR API Key** at `/admin/config/ai/providers/dxpr`. ## What's next? - [Build your first page](/hc/documentation/learn-dxpr-builder/getting-started/first-page): add sections, rows and elements. - [Installing the demo content](/hc/documentation/learn-dxpr-builder/getting-started/installing-simple-demo): other ways to try the builder with ready-made pages. - [User profiles](/hc/documentation/learn-dxpr-builder/admin/user-profiles-admin): decide what each role sees in the builder.