Skip to content

Resellers ​

A Reseller is an admin account that sells to its own customers. It sees and manages only the users it created, inside an allowance you set: a volume of traffic per cycle, an expiry date, a number of users, and optionally the plans it may sell. This page covers setting one up and what it sees.

The admins page: operator and reseller accounts, with each reseller's allowance and expiryThe admins page: operator and reseller accounts, with each reseller's allowance and expiry

What a reseller can do ​

A reseller signs in to the same panel and sees two pages:

  • Dashboard: its allowance (traffic used and left, its reset cycle and account expiry), counters for its users, and the list of its own users.
  • Users: its own customers only. It creates them, hands out their links, and, if you allow it, edits and deletes them. Filters, search, bulk operations and exports work on its own accounts.

It never sees another reseller's customers, your own customers, nodes, templates or settings. Its customers' notices can reach it through My Telegram and My email when you have those services on (see Telegram and Email).

Setting up a reseller ​

Resellers are made on Access → Admins, by the main admin.

  1. Press Add, and give a Username and Password.

  2. Set Role to Reseller, or to a role of your own based on the reseller tier (see Roles).

  3. Fill in the allowance:

    Field
    Volume allowancetraffic all of this reseller's users may use per cycle, in GB. 0 is unlimited.
    Reset cycleNo reset, Weekly, Monthly or Yearly, and Resets on day for the weekday or day of the month
    Account expiry (days from now)when the reseller's account ends. 0 never.
    Max usershow many accounts it may own. 0 is unlimited.
  4. Set what it may do:

    Field
    May edit and delete usersoff: it can create accounts but not change or remove them afterwards
    Sell from plans onlyon: every account it creates must come from one of the Allowed plans, with the plan's limits (see Plans)
    Subscription domainwhich of your subscription domains its customers' links use (below)
  5. Press Save and give the reseller its login.

On the admins list, the Allowance column shows each reseller's traffic used against its volume, and its expiry date is under its name.

Traffic allowance ​

A reseller's traffic is the sum of its customers' traffic since the start of the current cycle, counted the way the customers are charged: each node's traffic multiplier applies. When the cycle resets, the count starts again.

Limits on a role ​

A role based on the reseller tier can carry three caps that apply to every account on it, on top of each account's own allowance:

  • Users per account: how many users an account on the role may own.
  • Devices per user: the highest device limit it may give a user. A user with no device limit at all is then refused.
  • Plan length (days): the longest plan it may sell.

The tighter of the role's cap and the account's own value applies. See Roles.

A subscription domain per reseller ​

When you have several subscription domains, Subscription domain decides which one a reseller's customers are published under. Left on the default, they use the first configured domain.

Only the main admin sets this. A domain is what gets blocked as a unit, so choosing one is choosing whose customers go down together. If you remove a domain a reseller was on, its customers move to the first configured domain. See Subscriptions and the subscription page.

When a reseller runs out ​

The panel checks every reseller once a minute.

  • Over its volume allowance: every one of its customers is switched off until the next cycle starts, then switched back on.
  • Past its account expiry: every one of its customers is switched off, and the reseller can no longer use the panel. It is told This account has expired at login, its open sessions end, and its API tokens stop working.

Renewing the reseller (raising its allowance or moving its expiry on the admins page) lets it straight back in, and its customers come back on within a minute. Customers you or the reseller switched off by hand stay off.

Deleting a reseller ​

Deleting a reseller hands its customers to the panel: they keep working and become yours. The API tokens bound to the reseller are deleted with it.

  • Admins: every kind of admin account.
  • Roles: tiers, permissions and caps.
  • Plans: the catalogue a reseller can be held to.
  • Users: what a reseller does with its customers.

Text and images under CC BY 4.0.