This software is licensed under AGPL.
This app is composed of two different parts, the web frontend (made using Django) and the binary firmware images builder (bash scripts that use OpenWrt's Image Builder).
Clone or download the source code (i.e. to the alterchef folder):
git clone https://github.com/libremesh/alterchef.gitIf you want to run Chef using the Django development server first install Chef's dependencies in a virtual environment:
mkvirtualenv alterchef
cd alterchef
pip install -r requirements.txtInitialize the database and create the chef administrative user:
cd altermeshfc
./manage.py migrate --settings=altermeshfc.dev_settings
./manage.py createsuperuser --settings=altermeshfc.dev_settingsThen run Django's web server:
./manage.py runserver --settings=altermeshfc.dev_settingsIf everything went good, you can now visit your Chef instance at http://127.0.0.1:8000/
Next time you don't need to create the virtual environment again, just activate it by typing workon alterchef and run the web server again.
To install the web app dependencies run pip install -r requeriments.txt inside a virtualenv. Then you can follow any howto that explains deploying Django. We recomend using gunicorn, nginx and runit. Here are some links:
The configuration of the webserver must include the downloads url. Nginx example:
location /downloads {
# LIST_DIR_ROOT is in settings.py
alias /home/openwrt/downloads;
autoindex on;
}There are some specific Django settings for this app that you must set. Installing in openwrt's home directory may look like this:
MAKE_SNAPSHOT = "bash /home/openwrt/altermeshfc/bin/make_snapshot" NETWORK_INCLUDES_PATH = "/home/openwrt/network_includes" LIST_DIR_ROOT = "/home/openwrt/downloads/"DEFAULT_PROFILE_SLUG = 'altermesh-nodo'