Sign inSign up

rguziy/billcore

By rguziy

•Updated 3 months ago

Billing system for utility and telecom — clients, services, tariffs, and billing periods.

Image
Developer tools
Content management system
0

971

rguziy/billcore repository overview

⁠BillCore

Lightweight billing system for utility and telecom providers. Manage clients, locations, services, tariffs, billing periods, and accruals in one place.

šŸ“ GitHub: https://github.com/rguziy/billcore⁠


⁠🐳 Quick Start with Docker Compose

The easiest way to run BillCore with PostgreSQL in one command:

curl -o docker-compose.yml https://raw.githubusercontent.com/rguziy/billcore/master/docker-compose.yml
JWT_SECRET=your_secret_here docker compose up -d

Open http://localhost:8080⁠ — default credentials: admin / admin


⁠Manual Setup

services:
  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: billcore
      POSTGRES_PASSWORD: your_password
      POSTGRES_DB: billcore
    volumes:
      - postgres_data:/var/lib/postgresql/data

  billcore:
    image: rguziy/billcore:latest
    restart: unless-stopped
    depends_on:
      - postgres
    ports:
      - "8080:8080"
    environment:
      DB_HOST: postgres
      DB_PORT: 5432
      DB_USER: billcore
      DB_PASSWORD: your_password
      DB_NAME: billcore
      SERVER_PORT: 8080
      JWT_SECRET: your_secret_here  # required

volumes:
  postgres_data:

Migrations are applied automatically on startup. PostgreSQL 14+ required.

Tag summary

Content type

Image

Digest

sha256:f5c219bdc…

Size

11.9 MB

Last updated

3 months ago

docker pull rguziy/billcore