Your first project

A project is the unit of isolation in SimpleOTA. Devices, firmware, deployments, build numbers, and API tokens are all scoped to a project.

Create

1. Open the dashboard.
2. Click Projects → New project.
3. Pick a slug. The slug is immutable: it's part of every API URL. Use lowercase, hyphenated names: office-thermostat, sea-buoys-v2.
4. Save.

Generate a project API token

Project-scoped tokens are how devices and CI pipelines authenticate.

1. Open the project.
2. Tokens → New token.
3. Copy the token immediately. It is shown once; SimpleOTA only stores a salted hash.
4. Give it a meaningful name (ci-upload-bot, factory-flash-rig) so you can revoke individual tokens later without rotating the world.

Token scope

A project token can register devices and upload artifacts in that project only. Personal API tokens (PATs) span all projects you own; use them for human/admin operations, not for shipping devices.

Next

Register your first device →