Getting started


Published: 4 months, 3 weeks ago   491


What is doprax?

Doprax is an online platform for you to develop & deploy your python websites, apps, or APIs. The only requirement to get started is a web browser. All development and deployments are done via your browser without the need to install any software or dependency on your local computer. It is cross-platform and works on your desktop as well as tablets and smartphones.

Doprax provides manages the servers and infrastructure so that you can focus on writing great websites and apps without tons of installations and the hassle of deployment.  Doprax does the management of the infrastructures and services in a transparent way. You can configure every aspect of the build and run of your project if you want. 

This document helps you get started using doprax for the development of production-ready web applications apps using doprax.

Signup

To use the doprax platform you need to signup first. Go to singup page and create an account. You need to pick a username, enter your email address and pick a secure password. By signing up you will get a free plan. Using our free plan you can use up to 512 MB of RAM and 5GB disk and use shared CPU. Doprax platform is very efficient and this amount of hardware resources can get you a long way. If you need more hardware resources you can always upgrade to our premium plan. See the pricing page for more information. 

 

create a project 

Your work in doprax is organized in projects. You can create projects from your dashboard and projects page. Give your project a title and description. You need to select a team for your project. For now, leave it at default. Then you need to choose a project type. Choose Django ubuntu which is a ready-to-use Django project on Ubuntu operating system.  Doprax supports various types of python based projects. By choosing blank, you can create a custom python app from scratch. For now, we will continue with Django ubuntu. Django projects also need a database. By selecting a database (here Mysql) a MySQL instance will be provisioned and configured to be used by your project.  Click next to go to step 2. 

Create a project in doprax

Create project form. Step 1.

Each project has it's own dedicated hardware resources i.e RAM, CPU, and Disk space. When you create a project you will be asked how much resources you want to allocate to your project in the development stage. You can always adjust the hardware resources of your project. On the left side, the hardware resources of the app (Django) can be set. On the right side, the hardware resources of your database (MySQL) can be set. We leave the values at their default. By clicking create project, your project will be created and the database will be provisioned.  

Create project in doprax. step 2 allocate hardware resources to the project

Create project form. Step 2.

The new project will appear in projects page in your dashboard. By clicking on project detail you will be directed to the "project detail" page that lists every property of your project. For now, lets click on open in editor to start working on our project.

A Django project created

Newly created project in "projects" page

Start Developing!

Each project has a main codebase. The codebase includes the source code of your app plus all scripts and config files that are needed to build and run your project on doprax. You can view and edit the codebase in the doprax editor. In the previous section, we have created a new project. To start the development of the project we need to open it in editor. Just click on "open in editor" and you will be redirected to the editor. The doprax editor looks like this:

doprax editor

doprax editor

On the top of the editor, there is a menu and a toolbar. Also, there is a link to the project URL. Each project is automatically assigned a subdomain with https. 

doprax editor toolbar and menu

Editor toolbar & menu

The ► button will run the project. Click on it and the project will start building and then it will be launched. when the run process is done, the website will be accessible via the link on the right side of the toolbar. 

On the left side of the editor, there is the sidebar (image below). The sidebar has four sections, Projects, Directory, Services, and components.  By default, the directory section is open. The codebase of the project along with the files and folders associated with it can be viewed and accessed. Click on files to open them in the text editor. The text editor is on the right side of the screen.

doprax editor sidebar

Sidebar of editor

Run the project

When you click the run button or any other kind of process is running on your project, a log window will appear at the bottom of the screen. You can also open this window by clicking the up arrow on it. Let's click on the run () button to run the project and see the logs. 

doprax editor log window

All the details about the building and launching process as well as other events can be seen in the log window. When the build process finishes and also the database initialization and migrations (makemigrations & migrate commands in Django) are done the Gunicorn process Will start and it will look like the image above. Then you can visit the project URL and you will see a page like this image below: 

Django project welcome page

Welcome page of the Django project after build and run processes are done.