> For the complete documentation index, see [llms.txt](https://docs.clore.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clore.ai/for-renters/order-management.md).

# Order Management

How to create and manage your GPU rentals on Clore.ai.

## Creating an Order

1. Pick a server on the [marketplace](https://clore.ai/marketplace) and press **Rent**.
2. The rent dialog walks you through three steps: **choose a Docker image** (or one of your saved templates), **configure it** (ports, environment variables, SSH key, Jupyter token), and **Confirm & pay**. At the last step you either rent on-demand at the listed price or switch to **Rent on spot** and place your bid (at least 1% above the current top bid in that currency, if the server has one).
   * The image picker groups a curated line-up by use case (dev, image and video, LLM, and mining), and each image lists the VRAM, CUDA version, and download size it needs where those are known.
   * The **Cost estimate** on the Confirm & pay step shows what the rental would cost and how long your balance in the chosen coin will last. For an on-demand rental it follows the rental length you choose (see [Rental Length and Auto-Renewal](#rental-length-and-auto-renewal)); for a spot bid you pick a duration that is only for the estimate and doesn't stop or limit the rental.
3. Confirm to pay from your balance (available currencies depend on which coins the server accepts). If you are not signed in or short on funds, you can sign in and top up right inside the dialog, no need to leave checkout.

> On servers showing an **N/M GPUs free** badge you can rent a subset of the GPUs and pick them in the GPU allocation step. See [Partial GPU Rental](https://docs.clore.ai/for-renters/partial-gpu-rental.md).

## Viewing Your Orders

1. Go to **My Orders** in the navigation
2. See all your active and past orders
3. Click on any order for details

### Order Statuses

| Status         | Meaning                               |
| -------------- | ------------------------------------- |
| **Pending**    | Order is being set up                 |
| **Running**    | Server is active and accessible       |
| **Completed**  | Rental period ended normally          |
| **Terminated** | Ended early (by you, host, or system) |
| **Outbid**     | Spot order - someone outbid you       |

## Order Details

Each order shows:

* Server specifications (GPU, RAM, storage)
* Connection info (IP, port, credentials)
* Start/end time
* Cost breakdown
* Logs and history

## Rental Length and Auto-Renewal

Every server has a maximum rental length set by its host, shown in the rent dialog. By default an on-demand rental ends when it reaches that length. In the **Rental length** block of the **Confirm & pay** step you can choose otherwise:

* **Renew automatically when it ends** (off by default). Tick it to let the rental continue past the host's maximum. Each time the maximum is reached, the rental renews on the same machine and container, as the same order with the same order ID, for another term of up to the host's maximum, at the host's price at that moment.
* **Only while the host's price is at or under** is your per-day price limit for renewals. It is prefilled at 1.25 times the host's current price; renter fees are added on top of the host's price.
* **Total rental hours (optional)** sets how long the rental runs in total, counted from its start. Leave it empty to keep renewing until you cancel. More hours than the host's maximum: the rental renews until that many hours in total are used. Hours at or under the host's maximum: a set-time rental that ends after those hours without renewing, and the price limit is not used.

A host can turn renewals off for a server; the rent dialog then says the rental ends after the host's maximum and shows no tickbox.

### On the Order Card

An on-demand order in **My Orders** shows its rental length and renewal state:

| Line                                                 | Meaning                                                                                       |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| **Requested: 12h** / **Requested: until you cancel** | The total time you asked for                                                                  |
| **Renews at \<time> at up to \<limit>/day**          | The order renews when the current term ends, while the host's price is at or under your limit |
| **Ends at \<time>, when the requested time is used** | Your requested hours end within the current term                                              |
| **Ends at \<time> without renewing**                 | The order ends with its current term                                                          |
| **Not renewed: \<reason>**                           | The renewal was declined, so the order ends with its current term                             |
| **Renewed once** / **Renewed N times**               | How many times the order has renewed                                                          |

Two actions sit beside these lines:

* **Edit auto-renewal** opens the same tickbox, price limit and total hours for the running order. It cannot end a rental early: hours below what you have already used are refused, so cancel the order to stop it now. In the last minute of a term the change is refused; try again once the order has renewed or ended.
* **Renewal history** lists every renewal with the old and new price, the term length and your limit, and every declined renewal with its reason.

### When Renewals Stop

A renewing rental keeps going until one of these happens:

* You cancel the order. It ends right away, like any rental.
* You turn auto-renewal off. The order ends with its current term.
* The total hours you asked for are used. The card reads **Ends at \<time>, when the requested time is used**.
* At a renewal, the host's price is above your limit, the host has turned **Allow auto-renewal** off, the server is no longer listed for your payment currency, the server is reserved for another renter, or your balance would not cover the first hour of the next term. The order then ends with its current term and the card shows **Not renewed** with the reason.

You are notified in the app and on Telegram when a rental renews and when a renewal is declined. If a renewal would currently be declined, you get an early warning up to 24 hours before the term ends, so you can raise the limit or top up. The usual *order ending soon* notice is sent within the final 24 hours when auto-renewal is off or the requested hours end in the current term.

### Billing on Renewal

A renewed rental is still billed per minute, at the host's price in effect when that term started. A price change by the host never changes a running term, only the price of the next one. No creation fee is charged on a renewal. When the host prices the server in USD and you pay in BTC or CLORE, the coin amount billed follows the exchange rate during a term, so it can drift above your limit; the limit is checked only at each renewal.

### Through the API

The same controls are on the API: `rental_hours`, `auto_renew` and `auto_renew_max_price` on [`create_order`](https://docs.clore.ai/for-hosts/api.md#id-10-create_order), [`set_order_auto_renew`](https://docs.clore.ai/for-hosts/api.md#id-16-set_order_auto_renew) to change them on a running order, and [`order_renewals`](https://docs.clore.ai/for-hosts/api.md#id-17-order_renewals) for the renewal history. [`my_orders`](https://docs.clore.ai/for-hosts/api.md#id-5-my_orders) returns the renewal state of each order.

> **Note:** Spot orders never auto-renew and have no rental length to set. Create a new order instead.

## Canceling an Order

### On-Demand Orders

1. Go to **My Orders**
2. Click on the active order
3. Click **Terminate**
4. Confirm termination

You stop being charged immediately upon termination.

### Spot Orders

Same process - but remember, with Spot you can also be terminated if outbid.

## Order History

View your complete rental history:

1. Go to **My Orders**
2. Filter by status or date
3. Click on any order for full details

### Exporting History

Order history can be viewed in your account for tracking expenses and usage patterns.

## Billing & Costs

### How Billing Works

* **On-Demand:** Charged per minute while the order runs; terminate anytime to stop the charges
* **Spot:** Charged per minute at your bid price while your offer holds the server

### Cost Breakdown

Each order shows:

* Base rental cost
* Platform fee
* Total paid

> **Creation fee:** a small one-time fee applies per order (see [Fee Structure](https://docs.clore.ai/for-renters/fee-structure.md)). It is charged only if the order stays active longer than 10 minutes, so quickly cancelled orders pay none.

### Refunds

* Early termination: You stop paying immediately
* Server issues: Contact support for potential refunds

## Communication with Host

### In-Order Chat

1. Open your active order
2. Use the **Chat** feature
3. Communicate directly with the host

### When to Contact Host

* Server not responding
* Specs don't match listing
* Need specific configuration
* Technical issues

## Order Logs

View what happened during your rental:

1. Open order details
2. Go to **Logs** section
3. See events like:
   * Order created
   * Server started
   * Connection established
   * Termination reason

## Tips for Managing Orders

1. **Monitor active orders** - Check regularly for any issues
2. **Set budget alerts** - Track your spending
3. **Save server favorites** - For easy re-rental
4. **Review renewing rentals** - Turn auto-renewal off once you no longer need the server
5. **Terminate promptly** - Don't pay for unused time

## Common Questions

### Can I pause a rental?

No, rentals run continuously. Terminate and create a new order if needed.

### What happens if I run out of balance?

The order is terminated when your remaining balance covers less than five minutes at its current rate. A renewal needs enough balance for the first hour of the next term after the current term is paid for.

### Can I transfer an order to another user?

No, orders are tied to your account.

### How long until I can access a new order?

Usually 2-5 minutes after order creation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.clore.ai/for-renters/order-management.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
