Hostito

Open source web hosting billing & management system — built with NestJS and PostgreSQL (via Prisma).

---

What is Hostito?

Hostito is a free, open source alternative to WHMCS — built for the modern web.

No PHP. No expensive licenses. No ugly interfaces.

Just a clean, developer-friendly billing and client management system for hosting providers, built with a modern JavaScript stack.

---

Features

• Billing & Invoicing — automated invoice generation, due date reminders
• Client Management — admin panel, client portal, reseller support
• Product & Plan Management — hosting plans, domains, VPS, licenses
• Payment Gateways — Stripe, PayPal, crypto, manual payments
• Server Provisioners — cPanel, DirectAdmin integration (coming soon)
• Notifications — email and SMS support

---

Tech Stack

Layer	Technology
Backend	Node.js, NestJS
Database	PostgreSQL, Prisma
Auth	JWT (Passport, @nestjs/jwt)

---

Getting Started

# Clone the repo
git clone https://github.com/webito-io/hostito-core.git
cd hostito-core

# Install dependencies
npm install

# Setup environment
cp .env.example .env

# Generate Prisma client & run initial migrations
npm run prepare

# Start development server
npm run start:dev

---

Project Structure

hostito-core/
├── src/
│   ├── main.ts
│   ├── app.module.ts
│   ├── modules/
│   │   ├── auth/
│   │   ├── users/
│   │   ├── roles/
│   │   ├── organizations/
│   │   ├── products/
│   │   ├── orders/
│   │   ├── invoices/
│   │   ├── coupons/
│   │   ├── taxes/
│   │   ├── payment-gateways/
│   │   │   └── providers/
│   │   │       ├── stripe/
│   │   │       ├── paypal/
│   │   │       └── crypto/
│   │   ├── provisioners/
│   │   │   └── providers/
│   │   │       ├── cpanel/
│   │   │       ├── directadmin/
│   │   │       ├── proxmox/
│   │   │       ├── pterodactyl/
│   │   │       ├── vpn/
│   │   │       └── license/
│   │   ├── domains/
│   │   │   └── providers/
│   │   │       ├── spaceship/
│   │   │       └── resellerclub/
│   │   ├── notifications/
│   │   │   └── providers/
│   │   │       ├── smtp/
│   │   │       └── sms/
│   │   ├── services/
│   │   ├── announcements/
│   │   ├── audit-logs/
│   │   └── notification-templates/
│   └── common/
│       ├── guards/
│       ├── decorators/
│       └── interfaces/
├── prisma/
│   └── schema.prisma
└── test/

---

Scripts

• build — compile TypeScript to dist
• start — run production server
• start:dev — run dev server with watch
• lint — run ESLint with auto-fix
• test, test:watch, test:cov — unit tests via Jest
• test:e2e — e2e tests via Jest
• prepare — Prisma generate + migrate dev

---

API Reference

• Docs served at: http://localhost:3000/api
• Auth: Bearer JWT
• Generated via @nestjs/swagger + @scalar/nestjs-api-reference

---

Payment Gateways

Payment gateways are configured dynamically via database (CRUD). Each gateway stores its own API keys and config in a config JSON field.

Architecture: Controller → Handler → Factory → Provider

• Factory resolves the correct provider by gateway name
• Provider handles gateway-specific logic (initiate, verify, webhook)
• Handler orchestrates transaction/invoice status updates

Supported flows:

• Redirect-based (Stripe Checkout, ZarinPal-style) — initiate returns a URL, user pays, callback/webhook confirms
• Webhook-based — gateway pushes events to POST /payment-gateways/:gateway/webhook
• Callback verify — gateway redirects user to GET/POST /payment-gateways/:id/verify

Current providers: Stripe (implemented), PayPal (stub), Crypto (stub)

---

Roadmap

• Auth
• Users
• Products
• Orders
• Invoices
• Payment Gateways
• Coupons
• Servers
• Services
• Notifications
• Multi-currency

---

Environment Variables

Set these in your .env:

• DATABASE_URL — Postgres connection string
• PORT — server port (default: 3000)
• JWT_SECRET — secret for JWT tokens
• EMAIL_HOST, EMAIL_PORT, EMAIL_USER, EMAIL_PASSWORD, EMAIL_FROM — SMTP settings

Stripe config is stored per-gateway in DB (config JSON field):

• secretKey — Stripe secret API key
• webhookSecret — Stripe webhook signing secret
• successUrl — redirect URL after successful payment
• cancelUrl — redirect URL if user cancels

---

Sponsorship

We’re building modern, JavaScript-based, open source infrastructure for hosting providers and fintech:

• Hostito — hosting billing & management (NestJS + Prisma)
• Exito — crypto exchange platform
• Ledgito — accounting for exchanges and hosting

Your support helps us keep everything free and open source, invest in docs and community, and accelerate development.

• Sponsor: https://github.com/sponsors/webito-io

Thank you for believing in open source.

---

Contributing

Hostito is built by the community, for the community.

Whether you're fixing a bug, adding a feature, or improving docs — all contributions are welcome.

How to contribute

1. Fork the repository
2. Create a new branch — git checkout -b feature/your-feature
3. Make your changes
4. Write or update tests if needed
5. Open a Pull Request with a clear description

What we need help with

• 🔌 Payment gateway integrations (Stripe, PayPal, crypto)
• 🖥️ Server module integrations (cPanel, DirectAdmin, Plesk)
• 🌍 Translations and multi-language support
• 🧪 Writing tests
• 📖 Documentation improvements
• 🎨 Frontend (React) components

Please read CONTRIBUTING.md before submitting a PR.

Code of Conduct

Be kind. Be constructive. We're all here to build something great together.

---

License

MIT — free to use, modify, and distribute.

---