Skip to content
This repository has been archived by the owner on Feb 12, 2021. It is now read-only.


Repository files navigation

This repo is no longer maintained. Visit instead


Codacy Badge

This is a server for the ScanCode toolkit(

This is a work-in-progress...

The goal is to provide a minimal web UI and a comprehensive REST API to:

  • scan code for origin, licensing and dependencies for a remote URL, a remote repo or a file upload.
  • store scan results and eventually offer a central storage place for ScanCode scans even when done using the ScanCode CLI app.
  • offer some Travis and/or Github integration to scan on commit with webhooks.
  • eventually offer extra goodies such as scan based on a received tweet of similar IRC or IM integration.


Note: these instructions are tested only for now only on Debian and Debian derivative Linux distros.

The ScanCode server is designed to run on POSIX (Linux, Mac, etc). Windows is not tested and not supported for now.

  1. System requirements
  • Get Python 2.7.x installed first and pip (pip is included in the downloads since Python 2.7.9)

  • Install PostgreSQL 9.5.x of later. (9.6 preferred) On Debian distros use: sudo apt-get install postgresql-9.5-dev

  • Install extra utilities if needed: sudo apt-get install wget build-essential redis-server

  1. Configure a local test database
  • Create a local test scancode database user. Use scancode as password when prompted (otherwise use any password and update your settings locally). sudo -u postgres createuser --no-createrole --no-superuser --login --inherit --createdb --pwprompt scancode

  • Create a local testscancode database. createdb --encoding=utf-8 --owner=scancode --user=scancode --password --host=localhost --port=5432 scancode

  1. Install and configure the ScanCode server
  • Get a clone or archive for the code from

  • cd to the cloned or extracted archive directory

  • Create a local virtual environment with virtualenv . and activate this with source bin/activate

  • Install the required dependencies with pip install -r requirements.txt

  • Create the db schema python migrate

  • Create a local admin user with python createsuperuser

  • Run a local test server with python runserver

  • Run redis-server

  • Run a local celery worker in a separate shell with celery -A scanapp worker -l info

  • Fire a browser at to access the admin


  • If virtualenv is not available use these commands first to install it:
    • mkdir -p tmp && cd tmp
    • wget
    • tar -xf 15.1.0.tar.gz
    • cd ..
    • python2 tmp/virtualenv-15.1.0/ .
    • source bin/activate


This project is no longer maintained. Visit instead for similar and current project






No releases published


No packages published