freepost official repo. https://freepo.st

zPlus c0a38b3d80 Fix database REGEXP function. Use re.search() instead of re.match(). 4 days ago
freepost c0a38b3d80 Fix database REGEXP function. Use re.search() instead of re.match(). 4 days ago
.gitignore f3e0c86077 Move from mysql to sqlite. 5 days ago
.htaccess.cgi be631324d7 Initial port. 8 months ago
.htaccess.wsgi be631324d7 Initial port. 8 months ago
LICENSE b6a047b015 === Replace old freepost with new and different version === 3 years ago
README.md f3e0c86077 Move from mysql to sqlite. 5 days ago
database.schema.sql f3e0c86077 Move from mysql to sqlite. 5 days ago
favicon.ico b6a047b015 === Replace old freepost with new and different version === 3 years ago
freepost.cgi be631324d7 Initial port. 8 months ago
passenger_wsgi.py c54c323fd2 Add basic app sructure. 8 months ago
requirements.txt f3e0c86077 Move from mysql to sqlite. 5 days ago
robots.txt d6fde081e3 Move files to a separate directory. 8 months ago
settings.yaml f3e0c86077 Move from mysql to sqlite. 5 days ago

README.md

freepost

This is the code powering freepost, a free discussion board that allows users to post text and links that other users can read and comment.

Development

Setup Python3 virtual environment

cd freepost-directory
python3 -m venv venv (if this doesn't work, try `virtualenv -p python3 venv`)
source venv/bin/activate
pip3 install -r requirements.txt

Run test server

source venv/bin/activate
python3 -m bottle --debug --reload --bind 127.0.0.1:8000 freepost

Build stylesheets

Build CSS files

stylus --watch --compress --disable-cache --out freepost/static/css/ freepost/static/stylus/freepost.styl

Deployment

  • Build CSS stylesheets (see Development above)
  • Copy all files to your public_html folder
  • Make sure settings.yaml has restricted permissions, for instance 0600
  • If the SQLite database is located in the same HTML folder, make sure this too has restricted access
  • Rename .htaccess.wsgi or .htaccess.cgi to .htaccess (if you use CGI or WSGI)
  • Change settings in settings.yaml if needed
  • Create Python virtual environment For tuxfamily only: run newgrp freepost before creating the virtenv, for quota reasons
  • Create a new empty SQLite database: cat database.schema.sql | sqlite3 database.sqlite

Everything should be setup and working. Make sure your CGI or WSGI server is configured correctly.

License

freepost is free software licensed as GNU Affero General Public License, either version 3 or (at your option) any later version.