Datalix

Resell Datalix KVM VPS from Blesta - orders, renewals, panel access and stock levels all handled for you.

What it does

Selling Datalix KVM VPS servers usually means placing the order by hand, then chasing panel logins and renewal dates yourself. The Datalix module removes that: the moment a client's service goes active, Blesta places the order with Datalix, creates their control panel account, and stores the login details straight on the service. Renewals, lock-driven suspensions, and package stock levels are then kept in sync automatically for as long as the service exists.

Key features

• Automated VPS Ordering: The Datalix order is placed the moment a service is activated, and the panel account, login details and control panel address land on the Blesta service ready for the client.
• Automatic Renewals: Renewals are pushed to Datalix automatically and rounded to the whole 30-day periods the platform accepts, with package terms selectable from 30 up to 360 days.
• Live Server Status: A Server Status tab shows whether the VPS is running, stopped, installing or in error right now, alongside the product it is on and the date it expires, for both your staff and your client.
• Control Panel Access: A Control Panel tab gives the client their panel address, username, email and password with a single button that opens the panel, so they never have to ask support for their login.
• Automatic Lock Suspension: When Datalix locks a server, for example after an abuse report, the Blesta service is suspended on its own and unsuspended again the moment the lock is lifted, and suspensions you or your billing made for any other reason are left exactly as they are.
• Automatic Stock Syncing: Switch stock syncing on per package and Blesta keeps the available quantity in step with Datalix, correctly handling products that are sold out, unlimited or no longer active, so you never sell what cannot be delivered.
• Sell One Package Many Ways: Operating system, IP count and traffic allowance can each be overridden per order with a configurable option, so one package can sell several builds.
• One Panel Account per Client: Each client gets one Datalix panel account per interface, reused for every later order, so their servers stay together under a single login.

The Datalix reseller API has no suspend, upgrade or terminate endpoints of its own, so those actions are not sent to Datalix directly - see the usage guide for exactly what that means day to day.

Installing Datalix

Before you start

• If you are on the leased (subscription) licence, the Blesta Club Subscription Manager must be installed and your subscription active. The owned and owned-source licences have no such requirement.
• You will need a Datalix reseller API key. If you just want to try the module out first, you don't need one at all - a built-in Mock API Mode lets you test every screen with bundled sample data instead of a live account.

1. Upload the files

Upload the extension folder into your Blesta installation so it lands under your Blesta directory at:

components/modules/datalix/

For example, on a typical install: /var/www/html/blesta/components/modules/datalix/

2. Install it in Blesta

1. Log in to your Blesta admin area with a staff account that has the Modules permission (under Settings in Manage Staff Groups), including its Install Module sub-permission.
2. Go to Settings > Company > Modules and click the Available tab.
3. Find Datalix in the list and click Install.

3. Configure it

1. Go to Settings > Company > Modules, find Datalix in the Installed list, and click Manage.
2. Click Add Account to add a Datalix reseller account:
   • Enter a Name to identify the account (this is just a label in Blesta, it is never sent to Datalix).
   • Enter your Datalix API Key. If you want to test or demo the module first, leave the key blank or enter anything and tick Mock API Mode instead - every request is then served from bundled sample data and no server is ever ordered.
   • Save the account.
3. Two cron tasks (syncing locked/suspended servers and syncing package stock) register themselves automatically and run every minute on Blesta's own cron - there is nothing to schedule by hand.
4. Create or edit a package that uses the Datalix module and this account, then fill in its Module tab: choose the Interface, the Packet to sell, the default Operating System, IP Count and Traffic Count, and tick Sync Stock if you want the package's available quantity to follow Datalix's own stock levels automatically. Set the package's pricing terms in whole 30-day steps (30 up to 360 days) - Datalix bills KVM orders in 30-day periods, and the module will not accept anything else.
5. A ready-to-use welcome email template is included with the module and is applied automatically the first time you create a package, so new clients receive their panel login without any template writing on your part.

You're ready to go - see the usage guide for a walkthrough of day-to-day use.

Updating Datalix

Upgrading works just like installing: upload the new files over the old ones, then run the upgrade from the same page you installed it on.

1. Back up your current extension files first - good practice before any upgrade.
2. Upload the new version over the existing folder, replacing the old files.
3. Log in to your Blesta admin area and go to Settings > Company > Modules.
4. Find Datalix and click Upgrade to run the upgrade.

Version-specific notes

• v2.0.0: A live Server Status tab now appears automatically on every service for both staff and clients - there is nothing to enable. A ready-made welcome email template is now included and is applied automatically to any package you create from now on; existing packages keep whichever welcome email they already had, so update one by hand from Settings > Company > Emails if you'd like it to use the new template. Panel account passwords stored on services are now encrypted the next time each service is saved.
• v1.3.0: Account API keys are now stored encrypted, masked on the manage page, and no longer usable as an email placeholder - this happens automatically the next time you save an account, nothing to do beforehand. A new Mock API Mode checkbox is available on each account for testing and demos. If you configured a package's Packet before this version, open its Module tab once after upgrading and confirm the correct packet is still selected, since an earlier version could store the wrong one.
• v1.2.0: Package stock syncing became available - tick Sync Stock on a package's Module tab if you'd like its available quantity to follow Datalix automatically.

This upgrade is otherwise drop-in - no data migration is required for any of the above.

Using Datalix

For your staff

Managing Datalix accounts

Go to Settings > Company > Modules, open Datalix's Manage page, and you'll see two tables: your Accounts (each one a Datalix API key, or a Mock API Mode account for testing) and any Account Groups you've created to pool multiple accounts together. Click Edit next to an account to change its name, replace its API key, or toggle Mock API Mode - leaving the API Key field blank on save keeps whatever key is already stored, it is never cleared by accident. Click Add Account to add another one.

Setting up a package

On a package that uses the Datalix module, its Module tab lets you choose the Interface (the Datalix location/cluster to order from), the Packet to sell, the default Operating System, IP Count and Traffic Count, and whether to Sync Stock with Datalix's own availability. If you sell IP Count, Traffic Count or Operating System as configurable options instead of fixing them on the package, a client's selection at order time overrides the package default for that order.

Pricing terms are restricted to whole 30-day steps from 30 up to 360 days, matching how Datalix itself bills KVM orders.

What happens when a service is ordered

The moment a service goes active (and only if "Use Module" is ticked on it), Blesta places the order with Datalix, creates or reuses the client's panel account for that interface, and stores the resulting username, email, password and panel domain on the service. The welcome email - if applied to the package - is sent with those details filled in automatically.

If Datalix accepts the order but the panel account could not be attached, the service is still recorded (so it is never lost or unbilled) but the login fields are left empty and a red warning banner appears wherever the service's panel details are shown, telling you the account needs manual attention.

Viewing a client's panel login

Open the client's profile and expand their Datalix service in the client's services list - this reveals the Username, Email, Password and Web Panel URL exactly as issued by Datalix, the same details the client sees on their own Control Panel tab.

Server Status tab

Open the service for full management and you'll see a row of tabs including Server Status alongside the standard Basic Options, Add-ons and Advanced Options tabs. Server Status shows the server's current status, the product it's on, and its expiry date, pulled live from Datalix. If Datalix cannot be reached, it shows a friendly "unavailable" message instead of an error.

Renewals, suspensions and stock

• Renewals are pushed to Datalix automatically when the service renews, rounded to the nearest 30-day multiple.
• Suspension works one way only: if Datalix locks a server (for example after an abuse report), the cron suspends the matching Blesta service automatically, and unsuspends it again once Datalix lifts the lock. A service you or your billing suspend for any other reason - non-payment, a manual suspension - is left exactly as you set it; the sync only ever reverses locks it caused itself.
• Stock syncing runs on its own cron once enabled on a package: a sold-out packet sets the package's quantity to zero, an available packet restores unlimited quantity, and a packet Datalix has deactivated marks the whole package inactive.
• The Datalix reseller API has no suspend, upgrade, edit or terminate endpoints of its own. Manually suspending, editing, or upgrading a Datalix service with "Use Module" ticked is refused with an on-screen error telling you to untick it first; cancelling a service does not contact Datalix at all.

For your clients

Information tab

From My Services, clients can open their Datalix service to see an Information tab first, showing the standard plan details for any Blesta service.

Server Status tab

The Server Status tab, next to Information, shows the same live status, product and expiry date your staff see.

Control Panel tab

The Control Panel tab shows the client their panel username, email, password and domain, plus an Open Control Panel button that opens the panel address directly - so they never need to ask support for their login.

Good to know

• Mock API Mode lets you try every screen above - ordering, renewals, the Server Status tab, stock syncing - without a Datalix account at all. Records created while an account is in Mock API Mode are kept separate from real ones automatically, so switching a demo account back to live credentials later never mixes fake data with a real server.
• Each client gets one Datalix panel account per interface, which is reused for every later order they place on that interface - their servers stay together under a single login instead of a new one per order.