saw wiki: http://djangobb.org/wiki/QuickInstall [djangobb.org]
I felt like this should be present in some form on this website, since it did not appear to be found consistently anywhere. Had I had these steps, it would have saved me a couple hours worth of work digging up how to do it. Maybe I can save someone else that effort.
Please note that I installed my first copy/instance of django yesterday, and I'm not at all familiar with django or with djangobb. So I'm just identifying the steps I needed to perform to resolve the installation issues. Also, I've had more than a decade of using python.
PROJECT_ROOT – this is where your site is installed
DJANGOBB_SRC – this is where you placed the mercurial clone of django_bb
- A) Please ensure there is a working django setup underneath PROJECT_ROOT. This should be relatively easy to setup if the tutorial on the django website is followed.
B) You will need to setup a database. The quickest solution is to use sqlite3 and identify a file where you'll store the database. Note that this is not a good longterm solution.
C) These steps assume a vanilla setup. If there are files you would like to keep, make sure you save them off so they do not get overwritten.
D) The copy steps (steps 3 and 4) are unnecessary if djangobb is used as a standalone.
- 1. Install the required dependencies packages. See ‘Dependencies’ section here: http://djangobb.org/ [djangobb.org]
- a. Haystack requires Woosh. You can get it here: hg clone http://bitbucket.org/mchaput/whoosh [bitbucket.org]
- b. You need to use django-registration v0.7 (NOT 0.8a): http://bitbucket.org/ubernostrum/django-registration/get/v0.7.tar.gz [bitbucket.org]2. Download the django_bb package from the website. See ‘How to get DjangoBB sources?’ section here: http://djangobb.org/ [djangobb.org]
3. Copy the extra data from DJANGOBB_SRC into PROJECT_ROOT
- a. settings.py
- b. url.py
6. +Run the following command to start django: python manage.py runserver
- a. djangobb_forum/
- b. djangobb_index/
- c. *static/
- d. templates/
- e. forms.py
- f. search_sites.py
- g. sitemap.py
./manage.py syncdb --all
./manage.py migrate djangobb_forum --fake
7. Point your browser to http://localhost:8000/forum [localhost]
- a. settings.py
* Note: this assumes that you have chose static as your MEDIA_URL.
+ If this looks unfamiliar to you, then please take a look at djangos tutorial. The manage.py script is what runs django.