Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

ALISS Build Status

ALISS - A Local Information System for Scotland and Connecting you to your Community

JS Plugin

Embed ALISS search features on your own site with the aliss.js plugin.

How to install ALISS


  • Python 3
  • pip3
  • NPM (Node package manager)
  • See requirements.txt for pip packages
  • See package.json for node packages
  • Elasticsearch >=6.1.3
  • Postgres >= 9.0
  • Heroku toolbelt (only if deploying to Heroku)

Install steps

  1. Install requirements e.g. Python 3
  2. Clone repository
  3. If not installed download pip3
  4. Use pip3 to install the dependencies in requirements.txt on MacOS this can be achieved with pip3 install -r requirements.txt.
  5. If not already installed download NPM
  6. Install the npm packages using command npm i.
  7. Run gulp to compile assets
  8. Run migrations e.g. python3 migrate
  9. Configure environment variables & seed data (see 'Configuring ALISS')

Configuring ALISS

To run the ALISS project it is necessary to setup the environment on your machine and import data. NB if you are using heroku / heroku toolbelt you may need to preface these commands with heroku local:run e.g. heroku local:run python3 shell.

  1. Create a hidden file .env this will store necessary environment variables.
  2. With the use of .env.example copy the contents and customise with the relevant information for your environment.
  3. Ensure elasticsearch server is running systemctl start elasticsearch.service
  4. Import the place name/postcode data with management command python3 loaddata aliss/data/postcodes/
  5. Import geo-boundary data with management command python3 extract_geodata.
  6. Create a super_user account for local admin privileges using command python3 createsuperuser inputting an email address and password as per the prompts.

Common Commands

Command Description Further Information
heroku local -i Start the local server for running the app at localhost:5000 in your browser.
heroku local:run python3 test Run the automated tests
heroku local:run python3 shell Run the Django shell

Notes on data

Regarding boundaries and service areas see


ALISS (A Local Information System for Scotland) is a service to help you find help and support close to you when you need it most.







No releases published


No packages published