> For the complete documentation index, see [llms.txt](https://docs.timecord.dev/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.timecord.dev/docs/general/getting-started.md).

# Getting Started

### 1. Add the bot

First, [add TimeCord to your server](https://discord.com/oauth2/authorize?client_id=892476791082582066\&permissions=4503600030116880\&integration_type=0\&scope=bot+applications.commands).

### 2. Open the dashboard

Go to the [TimeCord Dashboard](https://timecord.dev/dashboard/guilds) and log in with Discord.

{% hint style="info" %}
Logging in uses Discord OAuth2, so we never see your password or any sensitive account data. You can read more about Discord OAuth2 [here](https://discord.com/developers/docs/topics/oauth2).
{% endhint %}

### 3. Configure your server

Select your server, then fill in the core fields:

1. **Management role** - the role allowed to manage the bot (your admins).
2. **On-duty role** - the role the bot gives members while they are clocked in.
3. **Duty channel** - where clock in / clock out messages are posted.
4. **Log channel** - where administrative actions are logged.

**Optional settings**

* **Auto-hire on join** - automatically hire members when they join. Hiring is what lets someone track time; you can dismiss them later if needed.
* **Autoroles** - pick roles that hire a member when added and dismiss them when removed.

### 4. Set your timezone and week start

So that daily and weekly totals match your team's calendar:

* Run `/timezone` and set your IANA timezone (for example `Europe/Berlin`). The default is `UTC`.
* Run `/weekstart` and choose the day your week begins on (premium).

See [Statistics & Time](/docs/guide/statistics-and-time.md) for details.

### 5. Hire your members

Use `/employee` with the `hire` action to allow a member to track time. To hire a lot of people at once, use `/role add` (premium) to hire everyone with a given role. See [Commands](/docs/guide/commands.md).

### 6. Generate the time clock

Run `/tracking` and pick the `generate` action. This posts a message with **Clock in** and **Clock out** buttons that your members use to track their time.

That's it. Your members can now clock in and out, and you can view time with `/info`, `/overview`, `/leaderboard`, and `/export`.
