## General
**What is Clore.ai?**
Clore.ai is a decentralized peer-to-peer GPU marketplace that connects GPU owners (hosts) with users who need computing power (renters). It's built for AI development, machine learning, rendering, and other GPU-intensive workloads.
**How does Clore.ai work?**
Clore.ai connects GPU owners with those needing computing power through a peer-to-peer marketplace. Hosts list their servers with pricing, renters browse and rent them by deploying Docker containers. Transactions are facilitated with Clore Coin and other supported currencies.
**What is Clore Coin (CLORE)?**
Clore Coin is the native cryptocurrency of the Clore.ai platform, used for transactions, fee payments, and rewarding users through the Proof of Holding (PoH) system. Paying with CLORE avoids extra currency conversion fees.
**What type of GPUs does Clore.ai offer?**
Clore.ai provides a wide range of GPUs, including NVIDIA GeForce, RTX, and professional-grade cards suitable for AI/ML, 3D rendering, and mining. Available hardware depends on what hosts list on the marketplace at any given time.
**Is Clore.ai decentralized?**
Yes. Clore.ai is a P2P marketplace — servers are owned and operated by individual hosts around the world. There is no single centralized provider. This means hardware availability, uptime, and performance vary by host.
**What can I use Clore.ai for?**
Common use cases include AI/ML model training and inference, LLM fine-tuning, image/video rendering, scientific computing, and cryptocurrency mining. Any GPU-intensive Docker-based workload is supported.
**What is the minimum and maximum duration for GPU leasing?**
Clore.ai allows GPU leasing for a minimum of 6 hours. The maximum duration is 3000 hours (approximately 125 days), offering flexibility for both short-term projects and long-term needs.
***
## Account & Security
**How do I create an account on Clore.ai?**
Visit [clore.ai](https://clore.ai) and register with your email address. After email verification, you can deposit funds and start renting or listing servers.
**How do I enable two-factor authentication (2FA)?**
Go to your account security settings and enable 2FA using an authenticator app (e.g., Google Authenticator or Authy). 2FA is strongly recommended to protect your account and funds.
**What do I do if I lose access to my 2FA device?**
Contact Clore.ai support with your account details and proof of ownership. Recovery without 2FA requires manual verification by the team.
**How do I reset my password?**
Use the "Forgot Password" link on the login page. A reset link will be sent to your registered email address.
**How do I delete my account?**
Contact Clore.ai support to request account deletion. Ensure you withdraw all funds before submitting the request, as balances on a deleted account may not be recoverable.
**Does Clore.ai require KYC (Know Your Customer) verification?**
Basic usage does not require KYC. However, for large withdrawals or compliance-related cases, the platform may request identity verification. Check the current requirements in your account settings.
**How do I generate an API key?**
Go to your account settings and navigate to the API section. Generate a new token there. Keep your API key private — it grants full access to your account via the API.
***
## Billing & Payments
**What payment methods does Clore.ai accept?**
You can deposit and pay using **Clore Coin (CLORE)**, **Bitcoin (BTC)**, **USDT (ERC-20)**, and **USDC (ERC-20)**. Paying with CLORE is recommended as it carries no extra currency conversion fees.
**Can I deposit USDT or USDC?**
Yes. Clore.ai supports USDT and USDC deposits on the **Ethereum network (ERC-20)**. Both stablecoins credit to a unified USD balance. Your USDT/USDC deposit address is the same as your CLORE deposit address. Always send on Ethereum — tokens sent on other networks (BSC, Polygon, etc.) cannot be recovered.
**Can I pay for GPU rentals directly with USDT or USDC?**
Currently, USDT/USDC are supported for deposits and withdrawals only. GPU rental billing uses CLORE or Bitcoin. Stablecoin rental payments are planned for a future update.
**Are there any fees on Clore.ai?**
Yes. On-demand orders carry a 10% base fee. Spot orders carry a 2.5% base fee. Both fees can be reduced by up to 50% through the Proof of Holding (PoH) system. Additionally, paying with non-CLORE currencies (e.g., Bitcoin) incurs an extra hoster fee that can be reduced to 0% via the MFP Lock system.
**What are extra hoster fees?**
When paying with non-CLORE currencies, an additional fee is charged. This fee can be reduced to 0% by locking CLORE in the [MFP Lock](/for-hosts/mfp-lock-a-complete-breakdown-of-mechanics.md) system. CLORE payments have no extra fees.
**What is the minimum deposit amount?**
Minimum deposit amounts vary by currency and network conditions. Check the deposit page in your account for current minimums. Deposits below the minimum may be lost or not credited.
**How do I withdraw funds?**
Go to your account wallet section, select the currency, enter your external wallet address, and submit a withdrawal request. Withdrawal fees vary by currency (e.g., for Bitcoin, the fee is approximately 0.0001 BTC).
**Are there refunds if a server goes offline during my rental?**
Clore.ai is a P2P marketplace — hosts are independent operators. If a server goes offline mid-rental, the platform may provide partial compensation depending on circumstances. When cancelling an order and reporting issues via the `cancel_order` API or UI, the team investigates reported problems. For reliable workloads, use on-demand leasing which provides non-interruptible sessions.
**How long do deposits take to confirm?**
Confirmation times depend on the blockchain network. Bitcoin typically requires a few confirmations (10–60 minutes). Ethereum-based tokens (CLORE, USDT, USDC) typically confirm within a few minutes depending on network congestion.
***
## For Renters
**How do I rent a GPU on Clore.ai?**
Browse the marketplace, filter by GPU type, price, and specs. Select a server, choose on-demand or spot leasing, configure your Docker image and port forwarding, and place your order. The container starts within minutes.
**What is the difference between Spot and On-Demand leasing?**
**On-Demand** leasing guarantees your rental for the full duration — no other user can outbid you. It carries a 10% base fee. **Spot** leasing is cheaper (2.5% base fee) but interruptible — another user can outbid your offer and take over the server. Use spot for fault-tolerant workloads like mining; use on-demand for training runs and critical jobs.
**How do I connect via SSH?**
When creating an order, specify your SSH public key in the `ssh_key` field or set an `ssh_password`. After the container starts, check your order details for the forwarded port and cluster endpoint (e.g., `n1.c1.clorecloud.net:10000`). Connect with: `ssh root@n1.c1.clorecloud.net -p 10000`.
**What Docker images can I use?**
Any public Docker Hub image is supported. Clore.ai also provides pre-built images (e.g., `cloreai/ubuntu20.04-jupyter`) with common ML frameworks, Jupyter, and SSH pre-configured. You can use your own custom images from Docker Hub.
**Can I use a Jupyter notebook on my rented server?**
Yes. Use a Jupyter-enabled image (e.g., `cloreai/ubuntu20.04-jupyter`) and forward port `8888` via `http`. Set a `jupyter_token` in your order configuration. The notebook will be accessible via an HTTPS proxy URL.
**Can I run a custom startup script?**
Yes. Pass a shell script in the `command` field of `create_order`. It runs after container startup. Alternatively, enable `autossh_entrypoint` to have Clore.ai automatically deploy an SSH server and execute `/root/onstart.sh`.
**How do I forward ports?**
In the order configuration, specify up to 5 port forwarding rules. Use `"tcp"` for raw TCP ports (e.g., SSH on port 22) and `"http"` for a port you want exposed via HTTPS proxy (e.g., Jupyter on 8888).
**What happens to my data when the rental ends?**
Data stored inside the container is **not persistent** by default — it is lost when the order expires or is cancelled. Save important data to external storage (S3, Backblaze, etc.) before your rental ends. Hosts may optionally support persistent storage — check server details.
**Can I cancel an order early?**
Yes. Cancel via the UI or the `cancel_order` API endpoint. If you experienced problems with the server, include an `issue` description — the Clore.ai team will investigate it.
**How do I use order templates?**
The Clore.ai web UI allows saving order configurations as templates, so you can quickly redeploy the same Docker image, environment variables, and port settings on different servers without re-entering everything.
**What should I do if my container won't start?**
Check that your Docker image name is valid and publicly accessible on Docker Hub. Verify that your port configuration is correct. If the server appears online but the container fails, cancel the order and report the issue. Try a different server.
**How do I set environment variables for my container?**
Pass environment variables in the `env` field of `create_order` as a key-value object. Variable names are limited to 128 characters and values to 1536 characters. The total stringified env object is limited to 12,000 characters.
***
## For Hosts
**How do I list my server on Clore.ai?**
Download and install the Clore.ai host software on your server, connect it to your account using the initialization token, configure pricing and visibility, and set it to public. Your server will appear on the marketplace when online.
**What are the minimum hardware requirements to become a host?**
There are no hard-coded minimum specs, but servers with at least one NVIDIA GPU and a stable internet connection are recommended. Servers with better GPUs, more RAM, fast NVMe storage, and high-speed networking will attract more renters and earn more.
**How is host pricing set?**
You set your own on-demand price per day and the minimum spot price per day. Prices can be set in Bitcoin or USD (USD billing coming soon). You can update pricing anytime via `set_server_settings`.
**How do hosts earn money?**
Hosts earn the rental price minus the platform fee. The fee hosts pay depends on the renter's payment currency: CLORE payments incur no extra fee; non-CLORE payments carry an additional fee that can be reduced to 0% via MFP Lock.
**What is MFP Lock?**
MFP (Marketplace Fee Program) Lock allows hosts to lock CLORE tokens to reduce or eliminate the extra fee charged when renters pay with non-CLORE currencies. Locking enough CLORE reduces this fee to 0%, maximizing host earnings.
**What is server rating and how does it affect me?**
Server rating reflects reliability based on uptime and renter feedback. Higher-rated servers appear higher in marketplace listings and attract more renters. Frequent offline periods and reported issues will lower your rating.
**What happens if my server goes offline while rented?**
If your server goes offline during an active rental, this negatively impacts your server rating. On-demand renters may receive compensation. Maintaining stable, high-uptime servers is essential for maintaining a good rating and steady earnings.
**Are there penalties for poor server performance?**
Yes. Frequent downtime, unresolved renter issues, and low ratings can result in reduced marketplace visibility or other restrictions. Operating a reliable server is important for long-term earnings.
**What is Maximum Rental Length (MRL)?**
MRL is the maximum number of hours a single rental can last on your server. You configure this via `set_server_settings` (`mrl` field, in hours). Setting a longer MRL attracts renters with longer-running workloads.
**Can I set a background job for when my server isn't rented?**
Yes. You can configure a background job (Docker image + command) that runs on your server when it's not being rented, for example to mine cryptocurrency during idle time.
**How do I update my server pricing?**
Use the `set_server_settings` API endpoint or the web UI. Changes take effect for new rentals — active orders are not affected mid-rental.
***
## Proof of Holding
**What is Proof of Holding (PoH)?**
Proof of Holding is a system where users earn rewards for holding CLORE tokens in their Clore.ai wallets. It incentivizes long-term participation in the ecosystem and rewards holders proportionally based on their holdings.
**How do I participate in Proof of Holding?**
Simply hold CLORE tokens in your Clore.ai account wallet. The longer and more you hold, the more rewards you accumulate. No staking contract or locking is required for basic PoH participation.
**What rewards do I get from PoH?**
PoH participants receive a share of platform fee revenue distributed in CLORE. Rewards are calculated based on your holding relative to the total CLORE in PoH.
**How does PoH reduce marketplace fees?**
Holding CLORE proportionally reduces the on-demand fee (base 10%) and spot fee (base 2.5%) by up to 50%. Maximum fee reduction (50%) is achieved at 2,000,000 CLORE held. The reduction is linear and applies to both renters and hosts.
**Is PoH the same as MFP Lock?**
No. PoH reduces platform fees for everyone (renters and hosts) based on CLORE holdings. MFP Lock is specifically for hosts to eliminate the extra fee charged when renters pay with non-CLORE currencies. Both mechanisms use CLORE but serve different purposes.
**Where can I track my PoH rewards?**
PoH rewards and your current balance are visible in your Clore.ai account dashboard under the PoH or wallet section.
***
## API
**How do I get an API key?**
Log in to your Clore.ai account, navigate to the API settings section, and generate a new API token. Keep it secret — it provides full access to your account.
**How do I authenticate API requests?**
Pass your API token in the `auth` header of every request: `auth: `. Do not use `Authorization: Bearer` format — Clore.ai uses the `auth` header specifically.
**What is the base URL for the API?**
All API endpoints are at `https://api.clore.ai/v1/`. Example: `https://api.clore.ai/v1/marketplace`.
**What are the API rate limits?**
The general rate limit is **1 request per second**. Exceeding this returns code `5`. The `create_order` endpoint has an additional stricter limit of **1 request per 5 seconds**.
**What do API response codes mean?**
| Code | Meaning |
| ---- | ----------------------------------------- |
| `0` | Success (Normal) |
| `1` | Database error |
| `2` | Invalid input data |
| `3` | Invalid API token |
| `4` | Invalid endpoint |
| `5` | Rate limit exceeded (1 req/sec) |
| `6` | Error — see the `error` field for details |
**What are the main API endpoints?**
| Endpoint | Method | Description |
| ------------------------- | ------ | -------------------------------------- |
| `/v1/wallets` | GET | Get wallets and balances |
| `/v1/marketplace` | GET | List all public servers |
| `/v1/my_servers` | GET | List your hosted servers |
| `/v1/my_orders` | GET | List your active/completed orders |
| `/v1/create_order` | POST | Create a spot or on-demand order |
| `/v1/cancel_order` | POST | Cancel an active order |
| `/v1/spot_marketplace` | GET | Get spot offers for a specific server |
| `/v1/set_server_settings` | POST | Configure your server settings |
| `/v1/set_spot_price` | POST | Update your spot market offer price |
| `/v1/server_config` | GET | Get configuration of a specific server |
**Does Clore.ai have a WebSocket API?**
The primary API uses REST (HTTP). For real-time data needs (e.g., monitoring marketplace changes), poll the relevant endpoints within rate limits. Check the official documentation for any WebSocket support updates.
**Can I automate order deployment with the API?**
Yes. The `create_order` endpoint lets you fully automate deployment: specify the server ID, Docker image, port forwarding, environment variables, SSH keys, and startup commands programmatically.
***
## Technical
**What GPU brands and models are supported?**
Clore.ai primarily supports **NVIDIA GPUs** (GeForce, RTX, Quadro, Tesla, A-series). AMD GPU support depends on host configuration and Docker image compatibility. Available models range from GTX 1080 Ti to high-end A100/H100-class cards, depending on what hosts list.
**What CUDA versions are available?**
CUDA version depends on the Docker image you deploy and the host's driver version. Official Clore.ai images (e.g., `cloreai/ubuntu20.04-jupyter`) include CUDA support. Use NVIDIA's official CUDA images or check the host's GPU driver version in the server specs before deploying.
**What are the Docker limitations on Clore.ai?**
Each order runs a single Docker container. Multi-container setups (Docker Compose) are not natively supported — you must include all services in one image or orchestrate them via a startup script. Privileged mode availability depends on the host's configuration.
**What network speeds can I expect?**
Network speeds vary by host and are listed in the server specs as upload/download in Mbps. Check the `net.up` and `net.down` values in marketplace listings before renting for bandwidth-sensitive workloads.
**What storage types are available?**
Storage depends on the host's hardware. Server specs list disk type (NVMe, SSD, HDD) and size. Disk speed (`disk_speed` in MB/s) is also shown. For fast I/O workloads, filter for NVMe servers.
**Is persistent storage between rentals supported?**
By default, container storage is ephemeral — data is lost when the order ends. Always back up important data externally (S3, IPFS, etc.) before your rental expires. Some hosts may offer optional persistent storage — check their server description.
**What are the minimum network requirements for hosts?**
Hosts should have a stable internet connection with adequate upload bandwidth for the number of GPUs they're serving. Low-latency, high-bandwidth connections (100 Mbps+ upload) provide better renter experience and higher server ratings.
**Can I run Windows containers on Clore.ai?**
Clore.ai is Linux-based. Docker containers run on Linux hosts. Windows containers are not supported. You can run Windows applications inside a Linux container using tools like Wine if needed.
**What happens if a server runs out of disk space during my rental?**
If the container fills available disk space, applications may crash or become unresponsive. Monitor disk usage during your session and clean up temporary files. Check the available disk size in server specs before deploying disk-heavy workloads.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.clore.ai/help/faq.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.