Find file
Fetching contributors…
Cannot retrieve contributors at this time
76 lines (47 sloc) 1.89 KB


$ git clone
$ cd Faucet
$ git submodule init 
$ git submodule update
$ perl Makefile.PL
$ make installdeps


Install SQLite3 DB and import schema into faucet.db:

sqlite3 faucet.db < schema.sql


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 and use obtained application and secret IDs in this config file.

Run development server

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

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

Deployment under Apache

Enable FastCGI module:

a2enmod fastcgi 

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

FastCgiServer /home/faucet/Faucet/ -processes 2

<VirtualHost *:80>
  DocumentRoot  /home/faucet/Faucet/root
  Alias /static /home/faucet/Faucet/root/static
  Alias / /home/faucet/Faucet/script/

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.