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

# First run: claim your plamotrack instance and sign in

> After installing, your plamotrack instance is unclaimed. Follow these steps to retrieve the one-time setup token and set your owner password.

After [installation](/installation), plamotrack shows **Set up plamotrack** until you claim it. Each instance has one owner. The setup token proves that you can access the computer running the app; the owner password is what you will use to sign in afterwards.

These steps use the default password login. If you have deliberately configured OIDC, follow [OIDC login](/authentication/oidc) instead.

## Claim your instance

<Steps>
  <Step title="Find the setup token">
    Return to the terminal you used for installation. Run this from your `plamotrack` folder:

    ```bash theme={null}
    docker compose logs api
    ```

    Find the most recent message containing **This plamotrack instance has no owner yet**. The setup token is printed below it. Copy the token itself, without the surrounding log text.

    Your log will contain a message like this. The example token below is deliberately invalid:

    ```text theme={null}
    This plamotrack instance has no owner yet.
    Open http://localhost:8080 and enter this setup token with your new password:

        EXAMPLE-ONLY-NOT-A-REAL-SETUP-TOKEN
    ```

    Use the token from your own API log.

    <Tip>
      While the instance is unclaimed, each API restart creates a new token. If you need a fresh one, run `docker compose restart api`, then `docker compose logs api` again. Use the token in the latest startup message.
    </Tip>
  </Step>

  <Step title="Open the setup form">
    Open [http://localhost:8080](http://localhost:8080) on the same computer. If you changed the port during installation, use that port.

    The heading should be **Set up plamotrack**. A **Sign in** heading means the instance has already been claimed.

    <Frame caption="The setup screen. The token comes from the API log; the password is the one you will sign in with.">
      <img className="block dark:hidden" src="https://mintcdn.com/plamotrack/cX9ROK0TihQzUKyA/images/screenshots/setup-light.png?fit=max&auto=format&n=cX9ROK0TihQzUKyA&q=85&s=c55ae146d75044a0dbe8ea0c70962877" alt="The Set up plamotrack screen, with Setup token, Password and Confirm password fields and a Create owner button." width="2880" height="1440" data-path="images/screenshots/setup-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/plamotrack/cX9ROK0TihQzUKyA/images/screenshots/setup.png?fit=max&auto=format&n=cX9ROK0TihQzUKyA&q=85&s=7df74eeaecceb6685f329238de3bca91" alt="The Set up plamotrack screen, with Setup token, Password and Confirm password fields and a Create owner button." width="2880" height="1440" data-path="images/screenshots/setup.png" />
    </Frame>
  </Step>

  <Step title="Create the owner">
    Fill in all three fields:

    * **Setup token:** the token you just copied.
    * **Password:** a new owner password of at least 12 characters.
    * **Confirm password:** the same owner password again.

    Click **Create owner**.

    This password signs you into plamotrack. It is separate from the database password you put in `.env`; you do not need to enter that database password in the browser.
  </Step>

  <Step title="Start your collection">
    Successful setup signs you in and opens **Home**. Your collection is empty because you have not added anything yet.

    The setup token has now been used. On later visits, if you are signed out, enter your owner password on the **Sign in** screen.
  </Step>
</Steps>

## Add your first kit

For a kit you already own, you can start without recording a purchase:

1. Open **Kits** in the sidebar and click **Add kit**.
2. Enter its **Name** and **Grade**. For example, `RX-78-2 Gundam` and `HG`.
3. Set **Status** to **Backlog** if the kit is in hand and you have not started building it.
4. Add an optional **Scale**, **Kit number** or **Series**, then click **Add kit**.

Your kit now appears in **Kits** and the **Backlog** section on Home. When you start the build, edit it and change **Status** to **Building**.

<Frame caption="Add kit: only Name and Grade are required.">
  <img className="block dark:hidden" src="https://mintcdn.com/plamotrack/cX9ROK0TihQzUKyA/images/screenshots/kit-form-light.png?fit=max&auto=format&n=cX9ROK0TihQzUKyA&q=85&s=63560b651d0147930620e5da0edf742d" alt="The Add kit dialog with Name, Grade, Scale, Kit number, Series and Status filled in." width="896" height="1234" data-path="images/screenshots/kit-form-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/plamotrack/cX9ROK0TihQzUKyA/images/screenshots/kit-form.png?fit=max&auto=format&n=cX9ROK0TihQzUKyA&q=85&s=74a2206408cd47e87459b75661e28d1f" alt="The Add kit dialog with Name, Grade, Scale, Kit number, Series and Status filled in." width="896" height="1234" data-path="images/screenshots/kit-form.png" />
</Frame>

<Tip>
  If you want to record the purchase too, [add an order](/using/kits-and-orders#add-an-order) instead. An order creates its own kit records, so you do not need to add those kits a second time.
</Tip>

## Set your currency and time zone

A new instance starts with Australian defaults: prices in `AUD`, dates and numbers formatted for `en-AU`, and the `UTC` time zone. If that is not where you are, change it now, before you record an order:

1. Open **Settings → General** and set **Currency code** to the currency you buy in, such as `USD` or `JPY`, then click **Save**. New orders default to it. Amounts already recorded keep the currency they were entered with.
2. Open **Settings → Language & region**. Set **Time zone** to your IANA zone name, such as `America/Chicago` or `Europe/London`, and **Formatting locale** to how you want dates and numbers written, such as `en-US`. Click **Save**.

These settings belong to the instance, not the browser, so every device and connected AI assistant sees the same values. See [Settings](/using/settings) for the full list.

<CardGroup cols={2}>
  <Card title="Kits and orders" icon="plus" href="/using/kits-and-orders">
    Record purchases, shipping and arrivals, or update a build.
  </Card>

  <Card title="Import your collection" icon="file-import" href="/using/import-export">
    Bring an existing collection in with the starter spreadsheet.
  </Card>
</CardGroup>

## Sign in again

Use your owner password when the app asks you to sign in. You do not need another setup token.

<Frame caption="After setup, the Sign in screen asks only for your owner password.">
  <img className="block dark:hidden" src="https://mintcdn.com/plamotrack/cX9ROK0TihQzUKyA/images/screenshots/sign-in-light.png?fit=max&auto=format&n=cX9ROK0TihQzUKyA&q=85&s=ac7e45878f4581bcdec0abb548203370" alt="The plamotrack Sign in screen with a Password field and a Sign in button." width="2880" height="1440" data-path="images/screenshots/sign-in-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/plamotrack/cX9ROK0TihQzUKyA/images/screenshots/sign-in.png?fit=max&auto=format&n=cX9ROK0TihQzUKyA&q=85&s=75d428af6269c6c5166acfa195764044" alt="The plamotrack Sign in screen with a Password field and a Sign in button." width="2880" height="1440" data-path="images/screenshots/sign-in.png" />
</Frame>

## Forgot your password?

From the `plamotrack` folder on the computer running the app, run:

```bash theme={null}
docker compose exec api python -m app.auth.recovery reset-password
```

The command prompts for a new owner password and signs out active browser sessions. See [password login and recovery](/authentication/password-login) for the full instructions.

You can also configure [OIDC login](/authentication/oidc) to use an identity provider. That needs provider setup and the required environment settings; changing the login mode signs out existing browser sessions.
