README

A hosting infrastructure inventory tracker for OctoberCMS. Keep track of your hosts, sites, clients, and software installs — all in one place, with relationship tracking and a backend dashboard overview.

Features

• Hosts — Record servers and hosting environments with provider, IP address, type, monthly cost, and notes
• Sites — Track domains/websites linked to a host and client, with status and parent site support
• Clients — Manage client contact records linked to their sites
• Installs — Log CMS/software installs per site and host, including version, admin URL, and status
• Relationships — Full cross-linking between hosts, sites, clients, and installs
• Backend Dashboard — Overview panel accessible from the OctoberCMS backend navigation

Requirements

Installation

Via Composer (Packagist)

Run the following command from the root of your OctoberCMS project:

composer require fuascailtdev/inventory-plugin

Then run the database migrations:

php artisan october:migrate

The plugin will be installed to plugins/fuascailtdev/inventory and activated automatically.

Manual Installation

1. Download or clone this repository into your OctoberCMS plugins directory:

git clone https://github.com/ofthewildfire/inventory plugins/fuascailtdev/inventory

1. Run migrations:

php artisan october:migrate

Usage

Once installed, navigate to the OctoberCMS backend. A new Inventory Management menu item will appear in the left sidebar with the following sections:

Recommended workflow

1. Add your Clients first
2. Add your Hosts (servers/providers), optionally linking to a paying client
3. Add Sites (domains), linking each to a host and client
4. Add Installs (e.g. OctoberCMS, WordPress), linking each to a site and host

Data Structure

Client
  └── Sites (hasMany)

Host
  ├── Sites (hasMany)
  ├── Installs (hasMany)
  └── PaidByClient (belongsTo Client)

Site
  ├── Host (belongsTo)
  ├── Client (belongsTo)
  └── Installs (hasMany)

Install
  ├── Site (belongsTo)
  └── Host (belongsTo)

Changelog

v1.0.1

• Initial release
• Hosts, Clients, Sites, and Installs management
• Backend dashboard and navigation

License

MIT — see LICENSE for details.

Author

Fuascailtdev — github.com/ofthewildfire