# freepost
This is the code powering [freepost](https://freepo.st), 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 /usr/bin/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
# Deployment
- Copy all files to your `public_html` folder
- 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`
- 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
Everything should be setup and working. Make sure your CGI or WSGI server is
configured correctly.
## License
freepost is [free software](https://www.gnu.org/philosophy/free-sw.html) licensed
as GNU Affero General Public License, either version 3 or (at your option) any
later version.
`monkey` logo art by iko, released as CC0.