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

# Troubleshooting

Every CLI message is prefixed with `[baas]`, and commands exit with a non-zero code on failure (so they're safe to use in CI). Here are the messages you're most likely to see, and how to resolve them.

## Setup

| Message                                    | Fix                                                                                                                                                                                          |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Foundry is not installed or not in PATH.` | Re-run the [Quick install](/baas-cli/quickstart.md), which sets up Foundry automatically. Or install it from [getfoundry.sh](https://getfoundry.sh) and make sure `forge` is on your `PATH`. |
| `No 'src/' directory found.`               | Run the command from the root of your Foundry project.                                                                                                                                       |

## Authentication & projects

| Message                                             | Fix                                                     |
| --------------------------------------------------- | ------------------------------------------------------- |
| `Not logged in.`                                    | Run `baas login`.                                       |
| `Session expired.`                                  | Run `baas login` to re-authenticate.                    |
| `No active project selected.`                       | Run `baas use <project-id>`.                            |
| `Project "<id>" not found in your current session.` | Run `baas projects:list`, then `baas use <project-id>`. |
| `Rate limit reached.`                               | Wait a moment and try again.                            |

## Deployment

| Message                                                                 | Fix                                                                                    |
| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `No relayers found for this project.` / `No active relayers available.` | Create a relayer in the **BaaS Console**, then retry.                                  |
| `<Contract> has no creation bytecode …`                                 | The contract is an interface or abstract — deploy a concrete contract.                 |
| `<Contract>: Address <addr> is already registered with BaaS.`           | Nothing to do — the contract is already registered (this is a warning, not a failure). |

{% hint style="warning" %}
**`Deployment submitted but not confirmed within 120s`.** The transaction was submitted but not confirmed in time. **Don't re-run the command** (you'd deploy a second copy). Check the transaction and your relayer in the **BaaS Console** first; if it confirmed, the contract is deployed even though the CLI didn't register it.
{% endhint %}

## Next

* [Command reference](/baas-cli/reference.md) — every command and flag.
* [Configuration](/baas-cli/reference/configuration.md) — credentials and environment variables.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.baas.sh/baas-cli/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.