CodeRed CMS Quickstart

This page provides step-by-step instructions for how to get quickly started using CodeRed CMS on CodeRed Cloud.

Once you have signed up for a CodeRed Cloud account and logged into your Dashboard, you are ready to get started with building your site! This Quickstart tutorial covers basic CodeRed CMS setup on your CodeRed Cloud hosting.

CodeRed CMS is a content management system, based heavily on Wagtail, designed to provide a more professional alternative to WordPress. View the code on GitHub

Launch Your Site

You should see this screen in your Dashboard the first time. It will have a block where you can begin to launch your site.

Website dashboard landing screenshot

Click on the Create Website button to launch the website app creator.

Now you will be able to name your project and input other settings.

Create a new CodeRed CMS screenshot

The Handle that you create will be the website URL. Once you have filled out the basic information for your site, scroll down to Pick Your App. In this case, you want to choose CodeRed CMS. Select the Python and database versions you want.

Next, you will pick your plan level. You may see more options than what is available in the screenshot. Choose the plan level that you need for your projects.

Now click the Launch App button to get it started!

You should see a Pending screen at this point. This screen will only last for a few seconds while your site is being launched.

After your site is ready, you will see a Project Dashboard that provides information about your site.

Setting Up Your CodeRed CMS Site

Now that your site is launched, you will need to create a superuser to access the Wagtail Admin.

To log in to your new site:

  1. From the CodeRed Cloud dashboard, click Manage under your website, then click the Create Superuser link. This will prompt you for an email address and username for the new account.

    Create superuser in dashboard screenshot
  2. Once complete, you will be shown a password. Copy this password and store it somewhere safe, such as in a password manager.

  3. Now login with your new account by clicking the CodeRed CMS Admin button and entering the username and password to log in to the Wagtail Admin. To reset the password, follow the Forgot Password link from the Wagtail Admin.

Next Steps

To get started adding content to your CodeRed CMS site, follow the CodeRed CMS Tutorial.

Get Your Project Source Code

When launching your site, CodeRed Cloud created a boilerplate CodeRed CMS project. We recommend downloading these files and storing them in version control.

To download your code from the server, follow our SFTP Guide. Your project is located in the www folder on the server.

Working with Your CodeRed CMS Project

From here, you can develop locally as you usually would. When ready to deploy your local code to the server:

  1. Upload your local code to the server’s www folder using SFTP.

  2. Redeploy your app from the CodeRed Cloud Dashboard by doing to the Deployment tab and clicking Deploy Production. This will create a fresh Python environment on the server, install requirements, perform database migrations, and collect static files all at once.

    Alternatively, for minor code changes, you can click Restart Production which only reloads the web server with the new code; it will not update the Python environment or upgrade any pip packages.

Migrating Existing CodeRed CMS Sites

To load an existing CodeRed CMS site into CodeRed Cloud, follow these steps:

  1. Using SFTP, download the files of your current site from CodeRed Cloud.

  2. Using SFTP, you may now delete all of the files in the www folder on the server.

  3. Update your existing project code to include the necessary settings in settings/prod.py (and optionally settings/staging.py to use the staging environment on Professional plans). These files must be named exactly so. Read our Django Environment Reference for examples of Django settings files.

  4. If your site requires an existing database, or you need to clear out the current database and start fresh, please contact our support.

  5. At this point, you may now copy your existing project code to the server and deploy.