Giter Club home page Giter Club logo

dalgo-admin's Introduction

dalgo-admin

An administrative web console for Dalgo (https://dalgo.in/).

Dalgo is an open-source data platform for the social sector. Since it is open-source, anyone is free to run their own instance of the platform.

The dalgo-admin application allows you to monitor your instance of Dalgo to get an overview of

  • infrastructure usage
  • client accounts

Project Tech4Dev runs an instance of Dalgo as a paid subscription service, and features for dalgo-admin are primarily driven by the use-cases we encounter.

Installation

To install and run this app locally, you need to have Python v3.10, django v4.2, docker, postgres v14 or more and pip installed on your machine.

Clone the repository

  1. First, fork the repository and then clone the repository from GitHub using the following command on your local system:
git clone <repository_url>

Setup the Project

  1. Now change directory to the dalgo-admin project and take a look around
cd .\dalgo-admin
  1. Run virtual environment, install the required packages.
   pip install -r requirements.txt
  1. now change directory to the dalgo_admin
cd .\dalgo_admin

Setup Postgres database (by docker)

Note: you can setup postgres for the django in any way you want (it is considered easier using docker)

  1. Install docker on your system

For help refer: docker docs

  1. Now install postgres official image on docker and create an instance of it

For help refer: this link or docker docs

or any other article on web

  1. run the postgres instance from docker desktop or CLI

  2. Create a database and user in this instance from the Postgres prompt

for example,

CREATE DATABASE dalgo_db;
CREATE USER dalgo_user WITH PASSWORD '**********';
GRANT ALL PRIVILEGES ON DATABASE dalgo_db TO dalgo_user;

return to django project

  1. create a .env file in root directory
  2. Inside the .env file add the environment variables for the database with values you created above (check the .env.template for variables)
  3. Now apply the database settings to your django app
python manage.py makemigrations
python manage.py migrate
  1. run the server
py manage.py runserver
  1. Paste the given url on browser and see the app running

Cheers!! Now you are done with the Setup!!

dalgo-admin's People

Contributors

amansgith avatar fatchat avatar jayesh9747 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.