# Your first city

The onboarding at /comecar, field by field: you, the organization, the first server and the team.

Source: https://fivedash.fivex.gg/docs/en/getting-started/first-city

Right after you create your account, FiveDash opens the **Get started** screen (`/comecar`). There are four short steps to set up your city in the dashboard: **You**, **Organization**, **Server** and **Team**. Next to the form, a preview of the dashboard fills in as you type.

## Before you start

* Your account must be created and your e-mail verified. See [Create an account](https://fivedash.fivex.gg/docs/en/getting-started/create-account).
* Have your city's name, a logo (optional) and your FiveM server's public address (optional) at hand.
* The fivedash resource is **not** installed here. It's asked for later, when you open the first module.

> If you got an invite, the **Organization** step shows **You have an invite** with a **Join the team** button. People joining through an invite only fill in the **You** step.

## The steps

### You

Title **Tell us a bit about yourself**. Pick the **Profile photo** (or **Use initials**), enter your **Name** and, optionally, your **Discord**. Click **Continue**.

### Organization

Title **Create your organization**. Pick the **Icon**, the **Organization name** and the **Address**. When the address is free, **Available** shows. Click **Continue**.

### Server

Title **Add your first server**. Pick the **Icon**, enter the **Server name** and, optionally, the **Address**. Click **Add server**.

### Team

Title **Invite your team**. Add e-mails and each person's **Role**. Click **Invite 1 person** (or **Invite N people**), **Finish** if you didn't add anyone, or **Do this later**.

When you're done, **All set** shows and the dashboard opens asking for the organization's plan. See [Plans and billing](https://fivedash.fivex.gg/docs/en/getting-started/plans-and-billing).

> You can go back to any step with **Back**. Going back to the **Server** step edits the server you already added instead of creating another one.

## Fields in the You step

| Field             | What it does                                                                                                               | Rules                                                                                                      |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Profile photo** | Shown in the dashboard and in the team's activity. **Upload profile photo** opens the cropper (**Crop photo**), with zoom. | PNG, JPG or WebP, up to 10 MB. Without a photo, your initials are used.                                    |
| **Name**          | How your team sees you. Placeholder: "What does your team call you?"                                                       | Required, 2 to 64 characters                                                                               |
| **Discord**       | Your Discord username, shown on your profile. Placeholder: `your_username`                                                 | Optional. 2 to 32 characters: lowercase letters, numbers, `_` or `.`. You can paste it with a leading `@`. |

## Fields in the Organization step

| Field                 | What it does                                                                                                                 | Rules                                                                                                        |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Icon**              | Shown in the organization picker. **Upload organization icon** to use your logo, or **Generate another** to roll a new icon. | PNG, JPG or WebP, up to 10 MB                                                                                |
| **Organization name** | Visible to the whole team. E.g. "fiveX"                                                                                      | Required, 2 to 48 characters                                                                                 |
| **Address**           | Your panel's address: `/<address>` at the start of every page. You can change it later.                                      | 3 to 32 characters: lowercase letters, numbers and hyphens. It must be free and can't be a reserved address. |

Messages you may see on **Address**:

| Message                                         | Why                                                                            |
| ----------------------------------------------- | ------------------------------------------------------------------------------ |
| **Choose an address.**                          | The field is empty                                                             |
| **Use lowercase letters, numbers and hyphens.** | It has accents, spaces or other characters                                     |
| **This address is reserved.**                   | It's a name FiveDash itself uses (such as `admin`, `loja`, `regras`, `entrar`) |
| **This address is already taken.**              | Another organization uses it                                                   |

## Fields in the Server step

| Field           | What it does                                                                                                                                                                             | Rules                                                               |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| **Icon**        | Shown in the server picker and in the dashboard. **Upload server icon** or **Use initials**. Without an uploaded icon, FiveDash may use the server's own icon found through the address. | PNG, JPG or WebP                                                    |
| **Server name** | How your team sees this server. E.g. "Cidade Alta RP"                                                                                                                                    | Required, up to 64 characters                                       |
| **Address**     | To show the status and players from the Cfx.re server list, and the join button in Connect.                                                                                              | Optional. A `cfx.re/join/abc123` link or an IP like `0.0.0.0:30120` |

Possible errors on **Address**:

| Message                                                                                                          | What to do                                                        |
| ---------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| **Use a cfx.re/join link or an IP like 0.0.0.0:30120.**                                                          | Fix the format                                                    |
| **We couldn't find a server with this code.**                                                                    | Check the `cfx.re/join` code                                      |
| **The Cfx.re server list didn't respond. Try again.**                                                            | Try again in a moment                                             |
| **We couldn't find this address.** / **The server didn't respond. Check that it's online and the port is open.** | Start the server, open the port, or leave the field empty for now |
| **This address isn't public.**                                                                                   | Use the public IP, not a local network IP                         |
| **This server is already in this organization.**                                                                 | It was already added                                              |
| **This server is already in another FiveDash organization. If it's yours, contact …**                            | Contact support at the e-mail shown                               |

## Fields in the Team step

| Field             | What it does                                                                           | Rules                                       |
| ----------------- | -------------------------------------------------------------------------------------- | ------------------------------------------- |
| **E-mail**        | The e-mail of the person you want to bring in. Placeholder: `name@example.com`         | A valid e-mail. Your own e-mail is ignored. |
| **Role**          | **Admin** or **Member**. Admins manage servers and the team. Members access the panel. | Default: **Member**                         |
| **Add another**   | Opens one more row                                                                     | Up to 10 invites at a time                  |
| **Remove invite** | Removes the row                                                                        |                                             |

Invites stay pending until the person accepts. Someone joining as a **Member** from here starts out seeing the pages without being able to change anything; adjust their access later in **Settings → Members**. See [Team and permissions](https://fivedash.fivex.gg/docs/en/dashboard/team-and-permissions).

> Each plan has a team size limit, counting the owner and pending invites: 5 on **Plus**, 15 on **Pro** and unlimited on **Ultra**. If you invite more people than a tier allows, the plan you pick afterwards shows **Doesn't fit …** until you remove invites or pick another tier.

## After the onboarding

| What happens                                                          | Where                                                                                                                           |
| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| The dashboard asks for the plan (**Choose your organization's plan**) | As soon as you enter. See [Plans and billing](https://fivedash.fivex.gg/docs/en/getting-started/plans-and-billing).             |
| Modules ask for the fivedash resource (**Connect** + server name)     | When you open the first module. See [Install the resource](https://fivedash.fivex.gg/docs/en/getting-started/install-resource). |
| The organization's name, icon and address                             | **Settings → General**                                                                                                          |
| The server's name, icon, address and language                         | Server picker in the sidebar → **Manage servers**                                                                               |

## FAQ

**Can I create more than one organization?** Yes. In the organization picker (top of the sidebar), click **New organization**. Each organization has its own plan.

**I don't have the server address right now.** Leave it empty. You can fill it in later in **Manage servers**.

**I left in the middle of the onboarding.** Sign in again: the **Get started** screen comes back at the step where you stopped.

## Next steps

[Plans and billing](https://fivedash.fivex.gg/docs/en/getting-started/plans-and-billing)

Pick the tier and start the free trial.

[Install the resource](https://fivedash.fivex.gg/docs/en/getting-started/install-resource)

Link your city to the dashboard.

[Organizations and servers](https://fivedash.fivex.gg/docs/en/dashboard/organizations-and-servers)

Edit, add and remove servers.

[Invites and ownership](https://fivedash.fivex.gg/docs/en/dashboard/invites-and-ownership)

How your team accepts the invite.
