JB
JustBill
PHP & JSON Enterprise Architecture

Lightweight, open-source billing powered by JSON storage.

Complete client management, built-in support forum, knowledge base, and automated invoicing — built on PHP with zero heavy database overhead.

$ git clone https://github.com/Peer-W/Justbill.git

Full-featured billing ecosystem

Everything needed to manage subscribers, process orders, and handle support requests.

{ }

Flat-File JSON Storage

No complex database setups required. Configuration, settings, and records live in clean, portable JSON schemas inside the data/ directory.

UI

Client & Admin Portals

Separate, ready-to-use interfaces for administrators and clients to manage profile details, track invoices, and renew subscriptions.

KB

Community & Knowledge Base

Comes pre-packaged with an integrated help desk, knowledge base module, and discussion forum right out of the box.

Installation & Setup Guide

Follow these steps to deploy JustBill on your PHP web server or VPS.

1

Clone & Permissions

Clone to your web root and grant read/write access to the JSON storage directory.

# Clone into webroot git clone https://github.com/Peer-W/Justbill.git /var/www/html/justbill

# Set storage permissions sudo chown -R www-data:www-data /var/www/html/justbill
sudo chmod -R 775 /var/www/html/justbill/data
2

Build Frontend (Optional)

Compile styling and client dependencies using pnpm and PostCSS.

# Enter directory cd /var/www/html/justbill

# Install dependencies pnpm install

# Build assets pnpm run build
3

Run Web Installer

Navigate to the web installation wizard to set up admin credentials and basic configuration.

1. Visit http://yourdomain.com/install

2. Complete the setup wizard form.

3. Remove the installation folder:

rm -rf /var/www/html/justbill/install
Recommended Nginx Security Configuration nginx.conf
location / {
    try_files $uri $uri/ /index.php?$query_string;
}

# Block direct public access to internal JSON storage
location ^~ /data/ {
    deny all;
    return 403;
}
          

Repository Layout

An overview of the JustBill codebase structure and modules.

/admin Administrative control panel & settings.
/client Client-facing dashboard & payment hub.
/data JSON settings, configs, and record store.
/install Initial setup wizard & initialization scripts.
/kb Knowledge base documentation engine.
/forum Built-in community forum discussions.
/hooks Event listeners and custom automation triggers.
/lib & /includes Core PHP utility classes and layout helpers.