/
Ceph S3

Ceph S3

Overview

Ceph is a powerful open-source distributed storage platform providing S3-compatible object storage through the RADOS Gateway. The cephs3 module for HostBill is the perfect tool for hosting providers looking to sell object storage services on their own self-hosted Ceph infrastructure. The automation covers the full account lifecycle - from provisioning new S3 users with unique access credentials, applying storage quotas, through suspensions and terminations. From the client panel, customers can easily retrieve their S3 access and secret keys to start using the service right away.

Activating the module

  1. If the module is included in your HostBill edition you can download it from your client portal.

  2. If the module is not included in your HostBill edition you can purchase it from our marketplace and then download it from the client area.

  3. Once you download the module extract it in the main HostBill directory.

  4. Go to Settings → Modules → Hosting Modules, find and activate cephs3 module.

Connecting HostBill with ceph

  1. Proceed to Settings → Apps → Add new App

  2. From Applications list select ceph

  3. Enter:

    1. Name - Name of this connection

    2. Hostname - hostname or IP address of your Ceph Dashboard instance

    3. Username - Ceph Dashboard admin username

    4. Password - Ceph Dashboard admin password

    5. Secure - enable to connect via HTTPS

    6. API Port - Port to connect to Ceph S3 API, defaults to 443 for https and 80 for http

    7. Client API URL - Optional, overrides API URL shown in client portal. Use full url with https://

    8. Auto-prefix Buckets - when enabled all buckets created by/for client will be auto-prefixed with related account id, to prevent potential naming collisions

      4. Verify entered credentials by clicking Test Connection to check if HostBill can connect
      5. Save Changes



image-20260331-123404.png

 

 

Adding ceph product

  1. In HostBill go to Settings → Products & Services, and Add new order page

  2. From Order Types select Other Services

  3. After creating order page add new product in it, provide name & Save changes

  4. In product configuration section proceed to Connect with App, select  ceph module and App server created in previous steps.

In the product configuration the following options are available:

  • Quota Limit - defines the maximum storage space available for the account, specified in GB. leave empty or set to 0 for unlimited storage

  • Bucket Limit - defines the maximum number of S3 buckets the client can create. leave empty or set to 0 for unlimited buckets

  • Auto Create Bucket - when enabled, HostBill will automatically create a default bucket upon account provisioning, using the client's username as the bucket name.

image-20260330-081315.png

Quotas / Metrics / Metered billing

This module supports Quotas / Account Metrics feature, so you can setup limits & display usages, trigger automation based on usage and bill actual resource usage.

Metrics / Quotas / Metered Billing:

  • Storage Used (MB) - total storage used by the account in MB

  • Storage Used (GB) - total storage used by the account in GB

  • Buckets - number of S3 buckets created by the account

image-20260330-081731.png

 

Configuring Client Functions   

In Products & Services → Your Order Page → Your Product → Client Functions you can control what features customer will have access to in client portal, by clicking Enable/Disable next to the given option. Use Edit button to adjust function appearance in the client portal.

  1. Access Details - displays S3 connection details to the client, including Access Key, Secret Key, User ID and S3 endpoint URL.

  2. Bucket Management - allows clients to create and delete S3 buckets directly from the client portal. Bucket limit defined in product configuration is enforced.

  3. User Management - allows clients to create and delete subusers with full access permissions. Each subuser receives its own set of S3 access credentials.

image-20260330-082200.png