Add instruction in the refstack.md file to install test requirements. Also add a default config.json file. Change-Id: Ie3a9a5cfc175b0ec8f5e5c57d767bd0af6a2d62e
1.3 KiB
Executable File
Refstack Quickstart
To run refstack for development or to have a gui for running tests behind your firewall.
Git you clonin'
git clone http://github.com/stackforge/refstack
cd refstack
Install dependencies (on ubuntu 13.x)..
apt-get install python-dev
apt-get install python-pip
easy_install -U setuptools
python setup.py install
pip install -r test-requirements.txt
Update the "app_address" parameter in the config.json file to the correct address of your refstack server.
Setup or update the database
NOTE: you are going to have to modify the db connection string in alembic.ini
to get this working
PROTIP: if you just want to test this out, use -n alembic_sqlite
to make a local sqlite db
alembic -n alembic_sqlite upgrade head
or
alembic upgrade head
If you've got mysql or another database of choice.
Plug this bad boy into your server infrastructure. We use nginx and gunicorn, you may use something else if you so desire.
For the most basic setup that you can try right now, just kick off gunicorn:
gunicorn -b 0.0.0.0:8000 refstack.web:app
To actually configure refstack, check out the config section and
crack open refstack.cfg in your preffered editor.
vim refstack.cfg
Now browse to http://localhost:8000