Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Bitcoin (or any bitcoin-based currency) Faucet
Perl CSS
branch: master

This branch is 6 commits ahead, 6 commits behind hippich:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
root
script
t
.gitignore
.gitmodules
Changes
Makefile.PL
README.md
agpl.txt
faucet_sample.conf
schema.sql

README.md

Installation

$ git clone https://github.com/hippich/Faucet.git
$ cd Faucet
$ git submodule init 
$ git submodule update
$ perl Makefile.PL
$ make installdeps

DB

Install SQLite3 DB and import schema into faucet.db:

sqlite3 faucet.db < schema.sql

Configuration

Copy supplied sample config file faucet_sample.conf to faucet.conf and edit it. Make sure to include correct login/password to bitcoind, keys for reCaptcha and AddThis.

You will need to specify full path to SQLite3 DB file. (Or you might want to configure it to use MySQL/PostgreSql DB)

Also for Facebook authentication you will need to register new application at http://www.facebook.com/developers/ and use obtained application and secret IDs in this config file.

Run development server

Install Catalyst::Devel and run script/faucet_server.pl to test the application.

cpanm Catalyst::Devel
FAUCET_DEBUG=1 ./script/faucet_server.pl -r

Deployment under Apache

Enable FastCGI module:

a2enmod fastcgi 

In /etc/apache2/sites-available/faucet.conf:

FastCgiServer /home/faucet/Faucet/faucet_fastcgi.pl -processes 2

<VirtualHost *:80>
  ServerName faucet.example.com
  DocumentRoot  /home/faucet/Faucet/root
  Alias /static /home/faucet/Faucet/root/static
  Alias / /home/faucet/Faucet/script/faucet_fastcgi.pl/
</VirtualHost>

Enable newly created virtual host config:

a2ensite faucet.conf 

Restart Apache:

/etc/init.d/apache2 restart 

Installation notes

  • Catalyst::TraitFor::Controller::reCAPTCHA

    For me it failed on one of tests so I had to force install it via:

    $ cpan -f Catalyst::TraitFor::Controller::reCAPTCHA

Submitting patches

This is very early code release and I expect to have some bugs and/or missing essential features. Please fork project on GitHub, fix issue and submit pull request back to merge into main tree.

Something went wrong with that request. Please try again.