Skip to content

Latest commit

 

History

History
56 lines (47 loc) · 1.54 KB

DEVELOPMENT.MD

File metadata and controls

56 lines (47 loc) · 1.54 KB
Raw

Run your local development copy of PgManage on Ubuntu

Install the necessary OS packages

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get update
sudo apt-get install git libssl-dev python-protobuf build-essential
sudo apt-get install python3.9 python3.9-dev python3.9-venv python3-wheel libpq-dev libldap2-dev libsasl2-dev

Set up app environment

Clone pgmanage repository; change to the root directory of cloned repository, checkout dev branch:

git clone https://github.com/commandprompt/pgmanage.git
cd pgmanage
git checkout dev

Install Dependencies and Run the App

  1. Activate the Python virtual environment created in the previous step:
python3.9 -mvenv .env
source .env/bin/activate
  1. Install Python dependencies using pip:
pip install -r requirements.txt
  1. Navigate to the pgmanage/app/static/assets/js/pgmanage_frontend/ directory and install front-end Node.js dependencies using npm:

Note

Node.js version 18.x is required

cd pgmanage/app/static/assets/js/pgmanage_frontend/
npm install
  1. Start a development front-end server:
npm run dev
  1. In a separate terminal session navigate to the pgmanage subdirectory of the project and start the application back-end service by running:
cd [project_root]/
source .env/bin/activate
cd pgmanage
./manage.py runserver

  1. When you see that the application server is ready, open http://localhost:8000 in your preferred web browser.

  2. Log in using the following credentials:

    • Username: admin
    • Password: admin