# Troubleshooting

> Fixes for the errors you’re most likely to see.

Source: https://tray.sh/troubleshooting · Markdown: https://tray.sh/troubleshooting.md

## Not logged in

```text
error: not logged in to acme.dev
```

Log in once on this machine, or set an API key.

```sh
$ tray login acme.dev
$ export TRAY_API_KEY=tray_k_…
```

## Zero Trust isn’t enabled

```text
error: Cloudflare Zero Trust isn't enabled on this account
```

Tray uses Zero Trust for sign-in. Open [one.dash.cloudflare.com](https://one.dash.cloudflare.com/), choose a team name and pick the Free plan. Cloudflare asks for payment details even on the Free plan, but doesn’t charge it. Then run `tray setup` again. In a terminal, setup waits for you instead.

## Site already exists

```text
error: q3-review already exists (last put from ~/work/x)
```

Someone put a site with this name from another folder. Replace it, or pick another name. Old versions are kept, so you can roll back.

```sh
$ tray put ./q3-review --replace
$ tray put ./q3-review -s q3-review-v2
```

## Too large

```text
error: deploy is 63 MB, over the 50 MB limit
```

tray lists the biggest files. Remove what you don’t need, like videos or source maps, and put it again.

## Site is public

```text
error: q3-review is public
```

Only private sites can be shared. Make it private first.

```sh
$ tray edit q3-review --visibility private
```

## Domain not found

```text
error: acme.com isn't on this Cloudflare account
```

Custom domains must be on the same Cloudflare account as your tray. Add the domain to Cloudflare, then try again.

## Can’t open a private site

```text
404 · Sign in to view
```

Private sites look like they don’t exist until you sign in. Ask them to click Sign in to view and use the email you shared with. Still 404? They aren’t on the share list yet.

```sh
$ tray share q3-review
$ tray share q3-review bob@acme.com
```

## A script you didn’t add

```html
<script defer src="https://static.cloudflareinsights.com/beacon.min.js" …></script>
```

That’s Cloudflare Web Analytics. When it’s on for your domain, Cloudflare adds this script to HTML pages, including your sites. It reports to your own Cloudflare account and sets no cookies. Tray doesn’t add it and doesn’t block it.

Don’t want it? In the Cloudflare dashboard, open Web Analytics, find your domain and turn off automatic setup. Want it on only some sites? Turn off automatic setup and add the snippet to those sites yourself.