Installation

Dependencies

• Python >=2.4
• Django 1.0
• Either MySQLdb or psycopg2 if you’re using mysql or postgresql.
• python-openid 2.x (1.x is not supported and looks like it wouldn’t)
• BeautifulSoup 3.0.4
• ElementTree, if you are using python < 2.5
• Python Imaging Library, if you need to use CAPTCHA (reCAPTCHA does not need it)
• feedparser, if you want to use friends list

Setup

• Download: hg clone http://hg.piranha.org.ua/byteflow/ (or download compressed archive, though the only way to update such archive is to download new copy).
• Create file settings_local.py from example settings_local.py.template in same dir and modify accordingly to your wishes. You can read help in Django docs.
• If you are using mysql or postgres, create user and database.
• Run ./manage.py syncdb (it is located in Byteflow directory)
• Then just follow any (1, 2, anything else) tutorial on Django install. We recommend to use apache + mod_wsgi as most stable and fastest setup if you have enough memory.

Notes

• Common mistake - if you are using SQLite, make sure the database and its parent directory are writable by the user which runs Byteflow itself. mod_python installations runs as Apache user, mod_wsgi can be run as any user (using Daemon mode).
• Read about DEBUG to be prepared - you must configure your web-server.

Installation tutorials from community

• Ubuntu + nginx + FastCGI installation guide on Ubuntu wiki
• Debian + apache2 + mod_python. Installation and setup guides by Oleg Leschinsky.
• lighttpd + fastcgi installation guide from Benjamin Smith
• Installing byteflow on dreamhost by William Stearns
• ByteFlow on CentOS 5 with Apache, mod_wsgi and MySQL by Michal Ludvig