Project Homepage: http://freejournal.org/ Example Node: http://freejournal.io/
The first step to installing FreeJournal is to ensure you have:
- A Linux-based operating systems (for security reasons, we do not support Windows)
- Python 2.7.3+
- PyBitmessage
- Python 2.x
- python-pip (the pip command)
- python-bitcoinlib
- FreeNet (install script provided)
If you are on Windows, you can still browse one of many existing FreeJournal nodes. Consult a list on our website.
To install database, documentation, and other library requirements, run
sudo pip install -r requirements.txt on the root directory.
After this, you should perform the required Freenet and Bitmessage setup using:
sudo ./freejournal_cli.py install all on a Debian-compatible distribution.
To generate API documentation, simply run
make install in the docs subfolder to install required dependencies, then run
make html to generate documentation in HTML form, output to the build directory.
Modify the following example commands to create and publish a collection:
./freejournal_cli.py putcollection whee 1,2,3 "This is a TEST" "nothing to see here" "nothing,to" btc123
Collection inserted with address/ID [BM-2cVBBDezMcgoAHMkNzMswkc3xZRMFFvKeV
./freejournal_cli.py publishcollection whee BM-2cVBBDezMcgoAHMkNzMswkc3xZRMFFvKeV
For more command usage instructions, run ./freejournal_cli.py with no arguments.
Simply coverage run --omit=*/python?.?/*,*/site-packages/*,*__init__*,test_*,*Freenet* -m unittest discover unittests
in the root directory after installing the required prerequisites to run all tests with coverage.
To start pulling and pushing collections to and from the network, use the following two commands:
./freejournal_cli.py keepalive and ./freejournal_cli.py listen
After configuring the web interface in config.py, use ./freejournal_cli.py webapp to run an insecure
development server. Hardened deployments should use the advanced deployment guides on the Flask
website.