Products
Products define what you sell to customers - the server resources, pricing, and deployment configuration. Each product maps to a specific hosting plan that customers can purchase through the storefront.
Creating a Product
- Navigate to Admin > Billing > Products.
- Click New Product.
- Fill in the product details and click Save.
Product Details
Every product has the following basic fields:
| Field | Description |
|---|---|
| Name | The product name displayed in the storefront |
| Slug | A URL-friendly identifier, auto-generated from the name |
| Description | A detailed description shown to customers on the product page |
| Category | The product category used to organize the storefront |
Resource Configuration
Each product defines the server resources allocated when a customer purchases it:
| Resource | Description |
|---|---|
| Memory | RAM in megabytes |
| Disk | Disk space in megabytes |
| CPU | CPU limit as a percentage (100 = one full core) |
| Swap | Swap memory in megabytes (-1 for unlimited, 0 to disable) |
| I/O Weight | Block I/O weight between 10 and 1000 (default 500) |
| Database Limit | Maximum number of databases the customer can create |
| Backup Limit | Maximum number of backups the customer can store |
| Allocation Limit | Maximum number of network allocations (ports) |
Pricing Types
Products support four pricing models:
Fixed
A single flat price for the defined resource set. The customer gets exactly the resources configured on the product.
Per-GB Memory
The price is multiplied by the amount of memory the customer selects, charged per gigabyte. Customers choose how much memory they want within the range you define.
Per-GB Disk
The price is multiplied by the amount of disk space the customer selects, charged per gigabyte. Customers choose their disk allocation within your defined range.
Configurable (Min/Max Range)
Customers choose their own resource amounts within minimum and maximum bounds you set for each resource. The final price is calculated based on per-unit rates for each resource type. This gives customers maximum flexibility.
Billing Cycles
Each product can offer one or more billing cycles. Customers choose their preferred cycle at checkout, and each cycle can have a different price:
| Cycle | Description |
|---|---|
| One-Time | A single payment with no recurring charges |
| Monthly | Billed every month |
| Quarterly | Billed every 3 months |
| Semi-Annual | Billed every 6 months |
| Annual | Billed every 12 months |
| Biennial | Billed every 24 months |
Longer billing cycles are typically offered at a discount to encourage commitment.
Setup Fees
You can add a one-time setup fee to any product. The setup fee is charged in addition to the first billing cycle payment. It appears as a separate line item on the initial invoice. Subsequent renewals do not include the setup fee.
Deployment Targeting
Control where servers created from this product are deployed:
- Nodes - select one or more specific nodes. The server will be placed on a node with available capacity.
- Orchestrators - select one or more orchestrators for Kubernetes-based deployment.
If multiple targets are selected, the panel automatically chooses the best available option based on current resource usage.
Egg Selection and Variable Overrides
Each product is linked to a specific egg that determines which game server type is deployed:
- Select the Egg that this product provisions.
- Optionally set Variable Overrides to lock or preset specific egg variables. For example, you might fix the Minecraft version to a specific release or set a maximum player count.
Variable overrides take precedence over the egg's default values. Overridden variables can be hidden from the customer or left visible but non-editable, depending on how the egg variable is configured.
Visibility and Limits
Visibility
- Visible - the product appears in the storefront and can be purchased.
- Hidden - the product does not appear in the storefront but can still be accessed via direct link or assigned manually by an admin.
Featured Status
Mark a product as Featured to highlight it in the storefront. Featured products are displayed prominently and may appear in a dedicated featured section, depending on your storefront layout.
Stock Limits
Set a Stock Limit to cap the total number of this product that can be sold. Once the limit is reached, the product shows as out of stock. Leave blank for unlimited stock.
Per-User Limits
Set a Per-User Limit to restrict how many of this product a single customer can purchase. This prevents one customer from consuming all available capacity. Leave blank for no per-user restriction.
Next Steps
- Payment Gateways - accepting payments
- Coupons - offering discounts
- Service Lifecycle - what happens after purchase
