> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinematic.run/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These are the customer docs for kinematic, a name written in lowercase except at the start of a sentence. Kinematic provides provably fair casino games, served to a casino's site by a game server: a Cloudflare Worker that the kinematic dashboard deploys into the casino's own Cloudflare account.
> Never put SESSION_SECRET or WALLET_SECRET in code, prompts, logs, commits or chat. Read them from environment variables and ask the person you work with to set them. The dashboard's Integration page shows each secret once.
> Values such as lucky-star, luckystar.example, og-rgs-lucky-star.luckystar.workers.dev, games.luckystar.example and player_48213 are examples. Use the casino's own casino ID, game server origin, element tag, session issuer and currencies: the Instructions for your coding agent on the dashboard's Integration page hold them, or ask the person you work with.
> To debug, start at https://docs.kinematic.run/troubleshooting and https://docs.kinematic.run/reference/errors. The wallet contract is at https://docs.kinematic.run/api/wallet.openapi.yaml.
> Sandbox bets are recorded on Solana devnet. Live game servers record nothing on Solana until the audited mainnet program is deployed.

# Create your casino

> Sign up, create your casino and finish the first-run steps: your casino, your team, size and price, currencies, games and look.

## Sign up

Open [app.kinematic.run/sign-up](https://app.kinematic.run/sign-up). Enter **Your name**, your **Work email** and a **Password** of 10 to 128 characters, tick `I accept the terms and the privacy notice.` and select **Create account**. You can also select **Continue with Google**, which uses your Google account and needs no confirmation email.

The dashboard then shows `Check your email` and sends you a confirmation link that works for 24 hours. Opening it confirms your email and signs you in. If the email does not arrive, select **Send the link again**. Until you confirm, signing in answers `Confirm your email first. A new link is on its way to your inbox.`

You stay signed in for 7 days. If you forget your password, select **Forgot your password?** on the sign-in page. The link it sends works once, for an hour, and changing your password signs you out on your other devices.

## Name your casino

With no casino yet, the dashboard opens the first step, `What is your casino called?`. Enter the **Casino name**, for example `Lucky Star`, and the **Website** your players visit, for example `luckystar.example`. Once the website reads as an address, the hint under it shows which pages can show the games, for example `Pages on luckystar.example and www.luckystar.example can show the games.` The website must be the public name of your site: no IP address, no port and no local name such as `localhost`.

Select **Continue**. The dashboard creates your casino:

* **Casino ID.** The dashboard makes it from the name: `Lucky Star` becomes `lucky-star`. You cannot type or change it, and it never changes. Accents are dropped, every run of other characters becomes one hyphen, an ID that would not start with a letter gets `casino-` in front, and one shorter than 3 characters gets `-casino` at the end. If another casino already has the ID, yours gets `-2`, then `-3` and so on up to `-9`, then four random letters. The result is 3 to 51 lowercase letters, digits and hyphens, starting with a letter. Your session tokens carry it as `tenant`, and your game server's default Worker name is built from it: `og-rgs-lucky-star`.
* **Mode.** The casino starts in sandbox mode. See [Sandbox and live](https://docs.kinematic.run/concepts/sandbox-and-live.md).
* **Games.** Every game is on.
* **Allowed origins and session issuer.** Both come from your website. A bare domain such as `luckystar.example` gives the origins `https://luckystar.example` and `https://www.luckystar.example`. A `www.` host gives itself and the bare domain. Any other host, such as `play.luckystar.example`, gives only itself. The issuer is `https://` followed by the host you entered. You can change all of them in [Settings](https://docs.kinematic.run/dashboard/settings.md#players-and-sessions).
* **Look.** The dashboard starts reading your website for the **Look** step at once, so its themes are often ready when you get there.

You can change the name and the website later in [Settings](https://docs.kinematic.run/dashboard/settings.md#casino).

## The first-run steps

The dashboard then walks you through your casino's setup, one question per page, with the steps listed on the left: **Your casino**, **Your team**, **Size and price**, **Currencies**, **Games**, **Look** and **Done**. **Go back** returns to the previous step, and a step you finished links back to its page. You can change every answer later.

**1. Your team**

`Who's building this with you?` Enter the email of each person who will set up the casino with you, such as your developer, and choose **Admin** or **Member**. **Admin** is chosen by default. Select **Send invitation** (or **Send invitations**); each invitation works for 7 days. See [Team](https://docs.kinematic.run/dashboard/team.md).

To set up the casino yourself, select **I'll do it myself**; once someone is invited, it reads **I'll do the rest myself**. Once you have invited an admin, choose between **Continue setup** and **Leave the rest to my team**, which takes you to **Home**: your admin continues the setup from there.

**2. Size and price**

`How much do your players deposit each month?` Move the **Monthly deposits** slider to one of its seven tiers, from `Under $250K` to `$10M and up`. The caption shows your tier's fee, for example `$263 a month, $789 billed each quarter`. Your sandbox is free; you pay your tier's fee once you go live, a quarter at a time. See [Billing](https://docs.kinematic.run/dashboard/billing.md).

**3. Currencies**

`Which currencies do your players use?` Select every currency your players bet in from the **Crypto** and **Fiat** groups, or type any other code under **Add another** and select **Add**. In the sandbox, **TEST** is selected for you: it is play money, and each test player starts with 100,000.00 TEST. Choose at least one currency and at most 16. You set each one's limits later on **Games**. See [Games and limits](https://docs.kinematic.run/dashboard/games-and-limits.md).

**4. Games**

`Which games will you offer?` Every game starts on; turn off any you don't want, keeping at least one. Then choose your **Return to player**: **99% (recommended)**, **98%**, **97%** or **96%**. Roulette, Baccarat and Blackjack keep their fixed rules. See [Return to player](https://docs.kinematic.run/concepts/return-to-player.md).

**5. Look**

`Match the games to your site` offers three themes made from your site's colours, fonts and logo: **Matched**, **Bold** and **Quiet**. Choose one and select **Use this look**. You can also select **Upload a screenshot instead**, and the themes come from a screenshot of your site; the dashboard offers the same when your site refuses to be read. **Keep the default look** moves on without saving a look. You can change the look any time on [Appearance](https://docs.kinematic.run/dashboard/appearance.md).

**6. Done**

`Your sandbox is ready` lists the two steps left before your first bet: deploy your game server, and put the games on your site. Select **Deploy your game server** to open [Game server](https://docs.kinematic.run/dashboard/game-server.md), or **Go to Home**. Opening this page finishes the setup.

**Your casino**, **Size and price**, **Currencies** and **Games** are required; you can skip **Your team** and **Look**. Only owners and admins can open the steps: a member sees `Only owners and admins set up a casino`.

## Home before launch

Until your casino is launched, **Home** shows `Launch your casino`, a checklist of five steps:

| Step | Action |
| - | - |
| Set up your casino | **Continue setup** |
| Deploy your game server | **Deploy**, or **Open game server** once it is deployed |
| Place your first bet | **Open integration** |
| Switch to live mode | **Open settings** |
| Pay for your first quarter | **Open billing** |

The first step you have not done shows its action. If you left the first-run steps before the end, **Continue setup** opens the first one you have not finished. Under the checklist, `For your developer` links to the [quickstart](https://docs.kinematic.run/quickstart.md) and to the instructions for a coding agent on **Integration**. Beside it, **Your games** previews the games in your casino's look, with scripted rounds and demo credits that never reach your game server.

Once all five steps are done, **Home** shows your last 24 hours instead. See [Go live](https://docs.kinematic.run/dashboard/go-live.md).

## Several casinos

One account can belong to several casinos, each with its own team, settings, game servers and billing. **Your casinos** lists them; select **New casino** there to create another. The casino switcher in the sidebar has **All casinos**, which opens that list, and **New casino**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.