Installing Hellolily by hand

Installing Hellolily with docker is recommended for most installations, but there may be cases where you find Docker not suitable. This installation describes how to install Hellolily without Docker.

Prerequisites

  • you have python 2.7 and virtualenv installed
  • you have git installed
  • you have nodejs, npm and gulp installed
  • you have postgresql up and running
  • you have elasticsearch up and running
  • you have rabbitmq up and running

Installation

  1. Make a virtualenv, checkout the Hellolily project and install gulp dependencies.
mkdir -p ~/projects/hellolily-env
cd ~/projects/hellolily-env
virtualenv2 .
. ./bin/activate
git clone git@github.com:HelloLily/hellolily.git
cd hellolily
npm install
gulp build
  1. Install all related Python packages.
pip install -r requirements.txt
pip install -r requirements-dev.txt
  1. Setup a postgresql database for Hellolily.
sudo su postgres
cd ~
createdb hellolily
createuser hellolily -s
echo "ALTER USER hellolily WITH ENCRYPTED PASSWORD 'c2cg63&(e';" | psql
echo "create extension unaccent;" | psql
exit
  1. Override settings using your own environment settings.
vim ~/projects/hellolily-env/hellolily/.env

DEBUG=1
MULTI_TENANT=1

DEFAULT_FROM_EMAIL=info@mydomain.org
SERVER_EMAIL=info@mydomain.org
EMAIL_USE_TLS=1
EMAIL_HOST=smtp.gmail.com
EMAIL_HOST_USER=info@mydomain.org
EMAIL_HOST_PASSWORD=
EMAIL_PORT=587

ADMINS=(('Yourname', 'your@email.com'),)

DATAPROVIDER_API_KEY=
# Make SECRET_KEY unique for your own site!
SECRET_KEY=abcdefghijklmnopqrstuvwxyz0123456789abcdefghijklmn

DATABASE_URL=postgres://hellolily:c2cg63&(e@localhost/hellolily

AWS_ACCESS_KEY_ID=aws_key
AWS_SECRET_ACCESS_KEY=aws_secret_access_key
AWS_STORAGE_BUCKET_NAME=aws_bucket_name

REDISTOGO_URL=redis://localhost:6379/0
CELERY_SEND_TASK_ERROR_EMAILS=0
  1. Do a first time migration of the models.
./manage.py migrate
  1. Create a search index for ElasticSearch.
./manage.py index
  1. Populate the database with some testdata.
./manage.py testdata
  1. Run the Django development server.
./manage.py runserver 0:8000

Open http://localhost:8000 in your browser to see the running Hellolily instance. You can login using user superuser1@lily.com and admin as password. Congratulations, you now have the first part of Hellolily running!

Head over to the next topic to complete your Hellolily installation.

Footnotes