LogoLogo
SourceSupportTraining
v6.x
v6.x
  • Introduction
    • Contributing Guide
    • Release History
      • 6.1.0
      • 6.0.5
      • 6.0.4
      • 6.0.3
      • 6.0.0
      • Upgrading From v5.x
    • About This Book
      • Author
  • Getting Started
    • Installation
      • System Requirements
      • *CommandBox Installation
      • Source Installation
      • Existing ColdBox Application
      • Docker
    • Updates
  • Usage
    • Using ContentBox
      • The ContentBox Dashboard
        • Home
        • About
      • Content
        • Publish Content
          • Blog
          • Sitemap
          • Content Editing Tips
            • Editor Features
            • Dynamic Variable Output
            • Markdown Support
            • Relocations
            • Scheduled Content
        • Custom Content
          • Content Store
          • Content Templates
          • Categories
          • Media Manager
          • Menu Manager
      • Comments
        • Inbox
        • Settings
      • Look & Feel
        • Active Theme
        • Global HTML
        • Themes
        • Widgets
          • Inserting a Simple Widget
      • Media Manager
      • Modules
        • Installing Modules
        • Managing Modules
      • Users
        • Manage
        • Permissions
        • Roles
      • Tools
        • Import
        • Export
        • Static Site Generation
      • System
        • Auth Logs
        • Geek Settings
        • Settings
          • Site Options
          • Admin Options
          • Security Options
          • Login Options
          • Content Options
          • Editor Options
          • Media Manager Options
          • Gravatars
          • Notifications
          • Mail Server
          • Search Options
          • Login Options
        • Security Rules
        • Updates
      • Widgets
        • An Easy Example
        • Inside the Page Editor
    • Developing For ContentBox
  • Front End Development
    • Front End Development
      • File Structure
      • JS and CSS Assets
      • Customizing Views
      • Customizing Layouts
      • Customizing Navigation
      • Global Variables
      • Managing Assets
      • Template Variables
      • The Content Store
    • Theme Development
      • Theme Settings
      • Theme UDFs
      • Theme Templates
      • Theme Layouts
      • Theme Views
      • Theme SEO Functionality
  • Back End Development
    • Back End Development
      • Overriding ContentBox Settings
      • Modules
        • Installing a Module
        • Using a Module
        • Module Locations and Conventions
        • Build a Module
        • Scaffold a Module
        • Theme your Module
        • Build an Admin Module
        • Adding Admin Menus to your Module
        • Adding Meta to your Modules
      • Widgets
        • Core Widgets
        • Simple Widget
        • Widgets with Arguments
        • Multiple Render Function Widgets
      • Interceptors
      • Accessing Logged in User
      • Customizing the Admin
      • Staying on the Upgrade Path
Powered by GitBook
On this page
  • Requirements
  • Download CommandBox
  • Starting CommandBox
  • Install ContentBox-CLI
  • Creating Your Database
  • Creating A ContentBox Site
  • Web Installer
  • Starting & Stopping
  • What's Next

Was this helpful?

Edit on GitHub
Export as PDF
  1. Getting Started
  2. Installation

*CommandBox Installation

The easiest way to install and run ContentBox CMS

Last updated 1 year ago

Was this helpful?

is a ColdFusion (CFML) Command Line Interface (CLI), REPL, Package Manager and Embedded Server. We will leverage the CLI in CommandBox to install, deploy and configure ContentBox.

Requirements

  • MacOS, Windows, or Linux

  • JDK 11+

  • A clean, empty directory on your machine

Download CommandBox

Starting CommandBox

Once you download and expand CommandBox, you will have the box.exe or box binary, which you can place in your Windows Path or *Unix /usr/bin folder to have it available system-wide. Then open the binary, and CommandBox will unpack itself in your user's directory: {User}/.CommandBox. This happens only once; the next thing you know, you are in the CommandBox interactive shell!

We can execute a-la-carte commands from our command line or go into the interactive shell for multiple commands. We recommend the faster interactive shell, which can remain open in your project root.

Install ContentBox-CLI

The first step in our adventure is to install the contentbox-cli package that will handle the installation, scaffolding, and management of ContentBox sites.

install contentbox-cli

Once installed, you can always run contentbox help to get the list of available commands and help information.

Creating Your Database

Create a database in your RDBMS of choice. Ensure you note the name of the database, the connection details, and its credentials. You will need them in the next step.

If you are using MySQL, make sure you use utf8mb4 for your database collation.

Creating A ContentBox Site

Now that we have our CLI installed create a new directory where we will create our site.

# Create a new directory and go into it.
mkdir mysite --cd
# Run the installer wizard
contentbox install-wizard

The wizard will take you by the hand and ask you all the relevant questions about your installation:

  1. Name of your site

  2. Which CFML Engine you want to run it on (Lucee5, Adobe 2018+)

  3. Password of the CFML engine administrator

  4. Password for the ColdBox HMVC Reinits

  5. Database of choice (MySQL5+, MSSQL, PostgreSQL, Oracle)

  6. Database credentials

  7. Development or production site

  8. Latest ContentBox version, specific or be bleeding edge

Confirm your settings, and the installer will configure the entire site, including ORM dialects, environment variables, etc. The installer will also connect to your database and run the creation migrations to seed the database.

It can optionally start your server of choice.

Tip: You can use the `install --help` command and see how to install ContentBox in an automated fashion without user interaction.

The installer will create a .env, .cfconfig.json in the root so you can further tweak those files if needed.

Web Installer

The web installer will then add your first administrator user, email configurations, and production and development site in one box. Once you follow the wizard, ContentBox is up and running! Enjoy!

The admin URL will be http://localhost:{port}/cbadmin

Starting & Stopping

You can use the CommandBox commands to interact with the embedded server:

  • server stop to stop the server

  • server start to start the server

  • server restart to restart the server

  • server log to view the log files

  • server help to get help on your server commands

What's Next

You now have a fully functional ContentBox installation with two sites: development and production. You can now start creating your content, themes, modules, and more.

You can download CommandBox from the official site: and install it in your preferred Operating System (Windows, Mac, Unix).

http://www.ortussolutions.com/products/commandbox#download
CommandBox
LogoInstallationCommandBox : CLI, Package Manager, REPL & More
Installation Instructions
CommandBox CLI
box shell