BoxBilling - Open source billing and client management software
Clone or download
Latest commit babbdd3 Jun 8, 2018

BoxBilling Download Latest

If you want to download BoxBilling for use please click on Download BoxBilling button above instead of git pull command or GitHub's Download ZIP button!

Build Status Scrutinizer Code Quality

Open Source billing software


  • PHP 5.6 | Does not support PHP 7.x
  • Linux Operating System (64-bit) | Does not support Windows Operating Systems.
  • PHP extensions:
    • mcrypt
    • curl
    • zlib
    • PDO
    • gettext
  • MySQL or any PDO compatible SQL server

Getting started

Please read documentation at to get started with BoxBilling


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request to develop branch

Using Vagrant

Vagrant is very well documented but here are a few common commands:

  • vagrant up starts the virtual machine and provisions it
  • vagrant suspend will essentially put the machine to 'sleep' with vagrant resume waking it back up
  • vagrant halt attempts a graceful shutdown of the machine and will need to be brought back with vagrant up
  • vagrant ssh gives you shell access to the virtual machine

Install vagrant-hostmanager plugin

$ vagrant plugin install vagrant-hostmanager

to update /etc/hosts file

Using Grunt

To create minified js and css files for theme admin_default run: ./node_modules/.bin/grunt from project root directory

If you want to use not minified versions of admin_default theme:

Virtual Machine Specifications
  • OS - Ubuntu 12.04
  • PHP - 5.4.*
  • Apache
  • MySQL 5.6
  • IP -
  • servername - boxbilling.test
  • target folder - /var/www/boxbilling



BoxBilling is licensed under the Apache License, Version 2.0. See LICENSE for full license text.