Bitcoin Faucet Rotator – Installation Instructions

Bitcoin Faucet Rotator website

First of all, thank you for your interest in this Bitcoin Faucet Rotator script. I hope you will gain some good use from it :). If you experience any complications installing this script, please let me know – I am willing to help you, and amend these instructions if necessary.

The steps below outline the instructions needed to install the script.


These instructions are for Linux-based servers using Apache 2.2+. If you have servers powered by other operating systems (e.g. Windows, MAC OS, etc.), please let me know, and feel free to contribute installation instructions for said operating system/s.

If you don’t currently have a server already, I highly recommend the USD$5/mo package from DigitalOcean. If you choose to sign up through my link, we will both get USD$10 credit :).

You can see a working version of the script, and some screenshots of the public and admin backend.


Before you begin installing the script, please make sure your server meets the following specifications:

  • PHP version – 5.5 or greater
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Mbstring PHP Extension
  • Tokenizer PHP Extension
  • Enable Mod Rewrite for Apache
  • Install Composer, Node.js, Node Package Manager, and Bower.


Step 1

Navigate to the root directory of your web server, then clone this repository.

For example, I would navigate to ‘/var/www’ and issue the following command:

git clone

Step 2

Once the cloning process has completed, go into the repository folder (or the directory you cloned the repository into), and issue the following command:

composer self-update && composer install

The first part of the command will update the Composer installation, then the second part will install all necessary dependencies required.

This process can take a few minutes, depending on your server resources and bandwidth speed.

Step 3

Once the Composer process has finished, we will need to edit the .env.example file with the related configuration values.

I am currently using MySQL as the DBMS for this site, but you can also use others – such as PostgreSQL.

If you have not made a database yet, do so now. Once you have, note down the details and add them into the .env file.

Once you have edited in the necessary configuration values, make a copy of the .env.example file and rename it as .env.

Step 4

Once Step three has been successful, you can now run the database migration and seeding commands. This sets up the database with the required tables, and seeds said tables with some values.

To begin this process, make sure you are in the root of the repository (or the directory you cloned it to) and enter the following commands:

php artisan migrate && php artisan db:seed

The first part of the command creates the database tables, and the second part seeds the database with the appropriate values.

If you encounter difficulty with this step, please let me know, and I will use feedback to make necessary modifications.

NOTE: To get referral income from the Bitcoin Faucet Rotator’s faucets, you will need to replace their URL’s with your referral links. Your user credentials to log in will have been seeded from the .env file you created in Step three. You can edit these when you log in to the script.

Step 5

Since this script is built on Laravel, it needs the ‘storage’ directory to have the correct access and ownership privileges to store cache and log files.

To do this, you can execute the following command – which will recursively alter access and write permissions on the folder:

chgrp -R www-data storage && chmod -R 775 storage

Step 6

After the command in Step five has been executed, you will need to set up the initial styling sources of the script – specified in the ‘bower.json’ file.

The Bitcoin Faucet Rotator script uses Bootstrap and Font Awesome styling for the ‘simple’ design. If you have installed Bower, execute this command:

bower install

If you are logged in as the root user, append ‘–allow-root’ to this command (it’s generally not recommended to run scripts as root).

Step 7

To bring all the relevant CSS files into one, and the same for Javascript files, this script relies on third-party libraries specified in the ‘package.json’ file.

If you have installed Node.JS and Node Package Manager, execute the following command:

npm install

This may take a few minutes to finish, depending on your server’s resources and bandwidth speed.

Step 8

With Step seven complete, we can now process css in the SASS files, combine and minify our CSS, and combine/minify our Javascript files. To do this, execute the following commands:

gulp copyfiles
gulp minifycss
gulp minifyjs

The first command copies jQuery, Bootstrap, FontAwesome, JQuery UI, CKEditor files to directories specified in the ‘gulpfile.js’ file.

The second command compiles SASS into CSS, combines CSS files into a single unified file, and combines Javascript/JQuery files into a unified Javascript file.

The third and fourth commands do as you might think – minify CSS and Javascript scripts respectively.

Step 9

To enable Laravel to function properly for the Bitcoin Faucet Rotator script, run the following command:

php artisan key:generate

Step 10

If you have a Linux-based server (as I am using), and are using Apache, use the following command to create an Apache sites file for your script:

touch /etc/apache2/sites-available/ 

Once you have created this file, enter the following into it:

    ServerAdmin [email protected]
    DocumentRoot "/var/www/"
    <Directory "/var/www/">
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        allow from all
    ErrorLog ${APACHE_LOG_DIR}/error.log
    # Possible values include: debug, info, notice, warn, error, crit,
    # alert, emerg.
    LogLevel warn
    CustomLog ${APACHE_LOG_DIR}/access.log combined

Once this file has the above in it, execute the following commands to load it into Apache:

a2ensite && service apache2 reload

Step 11

Barring any potential errors in the previous installation, the script should be successful installed. Visit in a (modern) web browser to see the functioning script in action.


If you encounter any errors during installation, please let me know by emailing me at emailme[AT]robertattfield[DOT]com. Eventually, I will like the installation process to be simpler, so having many users with different hosting platforms and requirements will improve this.

Tagged with: , , , , , , , , , , , ,
5 comments on “Bitcoin Faucet Rotator – Installation Instructions
  1. lathif says:

    hai rob…
    can you spesific how to install this script on shared hosting?

  2. Ed Linac says:

    great article.

    I played around with the project from github, quite nice work. I’ve modified a bit the controllers, I would like to submit a pull request, but I am not sure if it works as it should.

    also, i updated the laravel framework to the latest version, sounds like quite some good work, dependency updates went installing ok, wasn’t difficult to repair the breaking changes. can report the speed it’s a bit improved.
    also, added some testing unit. 🙂

  3. JL BTC PTC says:

    Thanks for good article about bitcoin faucet rotator installation.
    By reading your article I get good idea about faucet rotator installation.

  4. ufukya says:

    can it be used on a wordpress site?

  5. Ed says:

    heia. thanks for the tutorial. this still works!

Leave a Reply

Your email address will not be published. Required fields are marked *



This site uses Akismet to reduce spam. Learn how your comment data is processed.