The recommended way to set up a developer instance is through Vagrant. After installing Vagrant and VirtualBox, install as follows:

git clone https://github.com/demozoo/demozoo.git
cd demozoo
vagrant up

This will download an Ubuntu Jammy64 image, install dependencies, and fetch the latest public export of the Demozoo database. To start up the site:

vagrant ssh
# then within the Vagrant VM:
./manage.py runserver 0.0.0.0:8000

Alternatively you may need to run :

python ./manage.py runserver 0.0.0.0:8000

The site will now be available at http://localhost:8000/.

If you want to work with the search feature, you have to rebuild your database indices first:

./manage.py reindex

This will take a long time, but you only need to do it once.

All account passwords in the public database export are blanked, so you'll need to create a new account to log in. To create a superuser account:

./manage.py createsuperuser

and enter the account details when prompted.

The procedure above gives you a basic working Demozoo installation, but several features are unavailable due to needing additional configuration:

• file uploads (Amazon S3)
• screenshot processing
• background tasks (scene.org spidering, fetching screenshots from graphics releases...)

Instructions for these will be forthcoming, at least when someone asks for them :-)

Gasman [email protected] - https://twitter.com/gasmanic