When no version number is indicated, it is advisable to install the current development version from the repository.
- Python (>= 2.6) or PyPy (tested with 2.0 beta1)
- PostgreSQL
Here's how you start from scratch with a new mygpo install (assuming a Ubuntu 12.04 x86 install, 'should work' with other versions/archs as well).
If you are on a Debian/Ubuntu system, do:
sudo apt-get install erlang git python-pip python-dev libevent-dev
For creating logo thumbnails, install libraries for the various image formats. They are used by the pillow library.
sudo apt-get install libjpeg-dev zlib1g-dev libpng12-dev
Select a cozy place for the mygpo sources and clone it:
git clone git://github.com/gpodder/mygpo.git
cd mygpo
Now install additional dependencies locally (you could also use virtualenv or some other fancy stuff):
pip install -r requirements.txt
That's it for the setup. Now to initialize the DB:
cd mygpo
python manage.py migrate
..and here we go:
python manage.py runserver
Ok, so you need a user. This requires e-mails to be sent. If your machine is configured to send e-mail, that should work out well. If not, you can use the Django E-Mail File Backend to "send" mails to a local folder:
mkdir inbox
Now, edit mygpo/settings_prod.py (or create it) and add the following lines:
import os.path
EMAIL_BACKEND = 'django.core.mail.backends.filebased.EmailBackend'
EMAIL_FILE_PATH = os.path.join(os.path.dirname(__file__), '..', 'inbox')
Sometimes you might want to access the server from another machine than localhost. In that case, you have to pass an additional argument to the runserver command of manage.py, like this:
python manage.py runserver 0.0.0.0:8000
Beware, though, that this will expose the web service to your all networks that your machine is connected to. Apply common sense and ideally use only on trusted networks.
Certain data in the database is only calculated when you run special commands. This is usually done regularly on a production server using cron. You can also run these commands regularly on your development machine:
cd mygpo
python manage.py update-categories
python manage.py update-toplist
python manage.py update-episode-toplist
python manage.py feed-downloader
python manage.py feed-downloader <feed-url> [...]
python manage.py feed-downloader --max <max-updates>
python manage.py feed-downloader --random --max <max-updates>
python manage.py feed-downloader --toplist --max <max-updates>
python manage.py feed-downloader --update-new --max <max-updates>
or to only do a dry run (this won't do any web requests for feeds):
python manage.py feed-downloader --list-only [other parameters]
To set a user as publisher for a given feed URL, use:
cd mygpo
python manage.py make-publisher <username> <feed-url> [...]
Check the settings in mygpo/settings.py. If you want to change any settings, add them to mygpo/settings_prod.py with the correct value. If you want to avoid warning messages on startup, simply:
touch mygpo/settings_prod.py
Django comes with a development webservice which you can run from the mygpo directory with
python manage.py runserver
If you want to run a production server, check out