Skip to content

Linux Installation Guide

kmehant edited this page Jan 28, 2020 · 12 revisions

Installation Guide (Linux)

You can even refer to the Video Tutorial on-

Note: Installation process outlined here has been tested on Debian based Distros. While it should work on other distros, we haven't tested it.

Open Terminal and Execute the following commands

  1. Change Directory to the folder where you want to install Bassa
  2. To clone the project, type: https://github.com/scorelab/Bassa.git
  3. Go into the project directory by cd Bassa
  4. To start installation, run the following commands:
    $ ./setup.sh
    $ cd components/core/
    $ sudo python setup.py develop
    
  5. Now you need to setup the database for Bassa, run the following commands in the MySQL Terminal:
    create database Bassa
    
  6. Type the following commands in the root of the project:
    mysql -u root -p  Bassa < Bassa.sql
    
    Open components/core/DBCon.py in the project folder and setup database username and password.
    If the environment variables are being used, modify as following :
    _db=MySQLdb.connect("db", os.environ.get('YOUR_DB_USERNAME'), os.environ.get('YOUR_DB_PASSWORD'), os.environ.get('Bassa'))
    
    If the environment variables are not configured and hardcoded strings are being used, replace as :
    _db=MySQLdb.connect(host="localhost", user="YOUR_DB_USERNAME", passwd="YOUR_DB_PASSWORD",db= "Bassa")
    
  7. To test the server, run the following commands:
    $ cd components/core
    $ python Main.py
    
  8. For setting up the UI, change directory to 'Bassa' and run the following commands:
    $ cd ui
    $ npm install
    
  9. You need to install aria2c to start downloads through Bassa. Install it using
    $ sudo apt-get install aria2
    
    To make sure you now have aria2c installed, run:
    aria2c --enable-rpc
    
  10. To run Bassa, execute the following command in terminal: gulp serve For the first time, the login credentials are 'rand' and password is 'pass'

Troubleshooting

  1. While testing the servers, you can get a potential error of Flask directory not being found. To resolve this, execute the following commands:
    $ sudo apt install python-pip
    $ pip install Flask
    
  2. While giving the command npm install in step 9, you can get an error that says npm is not installed. To resolve this, execute the following commands:
    $ sudo apt install npm
    
  3. When you run into errors related to sass packages probably you might be using a bleeding edge node version. So node version 7 is highly recommended.