# Troubleshooting

Source: https://shipth.is/docs/troubleshooting

## Check first

[Before you begin]
Review the following basic checks.

- **Ensure you are using the latest version of `shipthis`**

  - Check the current latest version of ShipThis on [npm](https://www.npmjs.com/package/shipthis)

  - To check your installed version, run:

    ```bash
    shipthis --version
    ```

  - To upgrade to the latest version of ShipThis, run:

    ```bash
    npm install -g shipthis
    ```

- **Confirm that you are logged in**

  - Run the [`shipthis status`](https://shipth.is/docs/reference/status) command:

    ```bash
    shipthis status
    ```

  - You should see `YES` next to "Logged in":

    <pre class="terminal__body">

      <font color="#4CE64C"><b>david@sal9000</b></font>:<font color="#295FCC"><b>~/Desktop/game</b></font>$ shipthis status
      <font color="#FFFFFF"><b>STATUS</b></font>
        Logged in                               <font color="#4CE64C"><b>YES</b></font>
        Godot project detected                  <font color="#4CE64C"><b>YES</b></font>
        ShipThis project configured             <font color="#FF8787"><b>NO</b></font>
        Git repository detected (not required)  <font color="#4CE64C"><b>YES</b></font>

      <font color="#FFFFFF"><b>NEXT STEPS</b></font>
        $ shipthis game wizard
    </pre>

## Viewing build output

When building, use the `--follow` to collect the full output. This flag requires you to specify the `--platform` flag too.

```bash
shipthis game ship --platform android --follow
```

[![asciicast](https://asciinema.org/a/gKmZ0E1rJ4oiT9SyuSivXBZfY.svg)](https://asciinema.org/a/gKmZ0E1rJ4oiT9SyuSivXBZfY#shipthis-col80row24)

For additional debugging, you can include the `--verbose` flag - this enables detailed logging locally and on the build server, including running the Godot export with verbose output:

```bash
shipthis game ship --platform android --follow --verbose
```

## Common issues

### iOS Wizard Errors

<pre class="terminal__body">
Checking for com.shipthis.test.ios.game in apple portal...
    Error: Apple 403 detected - Access forbidden.
    Unable to process request - PLA Update available - You currently don&apos;t have access to this
    membership resource. To resolve this issue, agree to the latest Program License Agreement in
    your developer account.
</pre>

[Apple Developer Agreement]
This error occurs when the Apple Developer Program License Agreement has changed.  
Please log in to your [Apple Developer Account](https://developer.apple.com/account) to review and accept the latest agreement.

### Android wizard: Google Cloud project quota exceeded

<pre class="terminal__body">
Error creating project: The project cannot be created because you have exceeded your allotted project quota.
</pre>

[Too many Google Cloud projects]
This can appear in the Android wizard when creating the service account key. Google limits how many Cloud projects each account can have. View your projects in the [Google Cloud Resource Manager](https://console.cloud.google.com/cloud-resource-manager). Shut down unused projects (per project: **IAM & Admin** → **Settings** → **SHUT DOWN**) to free quota, or [request a quota increase](https://support.google.com/cloud/answer/6330231) from Google.

### Game is archived

<pre class="terminal__body">
 ›   Error: Game "a1b2c3d4" is archived. You cannot ship an archived game.
 ›   Try this: shipthis game unarchive --gameId a1b2c3d4
</pre>

[Archived game]
You cannot ship an archived game. Run the command that the error shows to unarchive the game, then ship again. See [Managing games](https://shipth.is/docs/guides/managing-games) for more about archived games.

## Still need help?

[Need additional support?]
If the steps above do not resolve your issue, you can reach out through the following support channels:

- [Join our Discord and open a ticket](https://discord.gg/gPjn3S99k4)
- [Email us directly](mailto:support@shipth.is)
- [Report a bug or issue on GitHub](https://github.com/shipth-is/cli)

When contacting support, please include:

- The exact command you ran
- The full output or error message
- Your operating system and `shipthis` version