Skip to main content
After 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 instead.

​
Claim your instance

1

Find the setup token

Return to the terminal you used for installation. Run this from your plamotrack folder:
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:
Use the token from your own API log.
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.
2

Open the setup form

Open 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.
The Set up plamotrack screen, with Setup token, Password and Confirm password fields and a Create owner button.The Set up plamotrack screen, with Setup token, Password and Confirm password fields and a Create owner button.

The setup screen. The token comes from the API log; the password is the one you will sign in with.

3

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.
4

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.

​
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.
The Add kit dialog with Name, Grade, Scale, Kit number, Series and Status filled in.The Add kit dialog with Name, Grade, Scale, Kit number, Series and Status filled in.

Add kit: only Name and Grade are required.

If you want to record the purchase too, add an order instead. An order creates its own kit records, so you do not need to add those kits a second time.

​
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 for the full list.

Kits and orders

Record purchases, shipping and arrivals, or update a build.

Import your collection

Bring an existing collection in with the starter spreadsheet.

​
Sign in again

Use your owner password when the app asks you to sign in. You do not need another setup token.
The plamotrack Sign in screen with a Password field and a Sign in button.The plamotrack Sign in screen with a Password field and a Sign in button.

After setup, the Sign in screen asks only for your owner password.

​
Forgot your password?

From the plamotrack folder on the computer running the app, run:
The command prompts for a new owner password and signs out active browser sessions. See password login and recovery for the full instructions. You can also configure OIDC login to use an identity provider. That needs provider setup and the required environment settings; changing the login mode signs out existing browser sessions.