Divio App Required  Divio Shell Required

In this short guide we will show you how to set up an Oscar Project on Divio Cloud.

Create the project

Login to the Control Panel (or sign up for free)

Click on Add new Project.

This will redirect you to the "Add new Project" creation screen. In addition to choosing a Name for your project, the following options are required to get started with the guide:

  • Creation: New
  • Region: Choose United States or European Union
  • Python: Python 2.7.x
  • Type: Oscar
  • Boilerplates: Blank Boilerplate

Click Create Project and continue to the Project’s Dashboard.

Set up and run the project locally

Install and launch the Divio App

Select your project and hit Setup to get started. The Divio App will run through a number of processes to set up the local project. It all happens automatically and takes just a few minutes.

Once this process has completed, you can actually start the local site by getting the local server running. Select Start to launch it. To open the local site in your browser, click the eye icon.

This will open your project in your default browser, and take you to the Django admin.

To get to the Oscar welcome page, visit /shop on your site. shop  is the default URL prefix for Django Oscar, but you can change this by setting the ALDRYN_DJANGO_OSCAR_URL_PREFIX  in your settings.py .

Configure Oscar


Login to the Django admin (by appending /admin to the site's URL in the usual way). Create a new user by hitting Add user and then sign in. (Learn more about how this works.)

Add a "not found" image

Oscar expects a "not found" image. Add a file called image_not_found.jpg (download Oscar's image) to your project's /data/media directory. 


Set an environment variable on your test and/or live server for MEDIA_ROOT to  '/app/data/media/'.

Make sure that you remove the data folder from your .gitignore file before you push your changes.

Further configuration

To learn how to setup and configure Oscar please check out their Get Started Guide: Build your own shop. Thanks to Divio Cloud you can skip the inital parts and start directly with Initial Data.

Important - where the Oscar guide refers to: 

Next steps

You've now created a new Django Oscar project on Divio Cloud, deployed it locally in the Divio Cloud environment, configured it at the Python level, and started editing it. The next step is to publish it on the web, using the Divio Cloud.

It's worth following our Get Started guide in its entirety to become properly familiar with the system and what you can do with it, but in the meantime, if you want to do it the quick way with a minimum of explanation, go straight to Step 5: Push changes to your server of that article - it'll show you how to push all your changes to the cloud and deploy the project live on the web.

Did this answer your question?