Skip to content

INSTALL.md

Latest commit

 

History

History
45 lines (34 loc) · 1.58 KB

INSTALL.md

File metadata and controls

45 lines (34 loc) · 1.58 KB
Raw

Quickstart for a Testserver:

Prerequisite

Both python and virtualenv are already installed

Manual procedure

  • Create a virtual environment: virtualenv venv;source venv/bin/activate.
  • Install requirements: pip install -r requirements.txt.
  • Create a project: django-admin.py startproject project;cd project
  • Link the project (TODO: add a setup.py): ln -s /path/to/firefox-profilemaker profilemaker.
  • Edit project/settings.py (from the venv project/project/settings.py)
    • INSTALLED_APPS: Add 'profilemaker', 'bootstrap3', 'jquery',
  • Edit project/urls.py and replace by:
from django.conf.urls import include, url
from django.contrib.staticfiles.urls import staticfiles_urlpatterns

urlpatterns = [
    url(r'', include("profilemaker.urls")),
]
urlpatterns += staticfiles_urlpatterns()
  • Init db with ./manage.py migrate
  • Start with ./manage.py runserver
  • Optional: To avoid using bootstrap from a CDN add: BOOTSTRAP3 = {'base_url': '/static/bootstrap/'} (and install bootstrap into the STATIC_ROOT)

Automatic procedure

⚠️ Installation will remove venv & project forlders

  • Install the environment: make install
    • Manually edit project/settings.py (as mentionned during the install)
  • Run the server: make run
  • Clean the project: make remove

Docker

  • make build: build the docker image
  • make up: run the container
  • make down: stop the container
  • make shell: open a shell on the running container

ℹ️ The addons should be placed in the extensions folder as well