This page provides step-by-step instructions for how to get quickly started using Wagtail 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 Wagtail installation on your CodeRed Cloud hosting.
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.
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.
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 Wagtail. 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 Wagtail¶
Now that your Wagtail site is launched, you will need to create a superuser to access the Wagtail Admin.
To log in to your new Wagtail site:
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.
Once complete, you will be shown a password. Copy this password and store it somewhere safe, such as in a password manager.
Now login with your new account by clicking the Wagtail 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.
Get Your Project Source Code¶
When launching your site, CodeRed Cloud created a boilerplate Wagtail 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
folder on the server.
Working with Your Wagtail Project¶
From here, you can develop locally as you usually would. When ready to deploy your local code to the server:
Upload your local code to the server’s
wwwfolder using SFTP.
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 Wagtail Sites¶
To load an existing Wagtail site into CodeRed Cloud, follow these steps:
Using SFTP, download the files of your current site from CodeRed Cloud.
Using SFTP, you may now delete all of the files in the
wwwfolder on the server.
Update your existing project code to include the necessary settings in
settings/staging.pyto 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.
If your site requires an existing database, or you need to clear out the current database and start fresh, please contact our support.
At this point, you may now copy your existing project code to the server and deploy.