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

# Services

A service is a container the platform runs and keeps running: an MCP server that gives your agents tools, a retrieval endpoint they ground against, an internal API of your own. You supply an image and per-replica CPU and memory, and the platform schedules it, restarts it when it exits, maintains the replica count, probes it for readiness, and makes it reachable at a stable address. Each service reports as Healthy, Degraded, or Failed, and the Replicas tab is where you find out which replica is responsible.

### Configuring a service

Configuration is split into sections, shown as a form or as YAML.

<div data-with-frame="true"><figure><img src="/files/1b3ESoKUYtmRHw1lTfZe" alt=""><figcaption></figcaption></figure></div>

* **Identity.** The service name, set at creation and fixed after.
* **Image.** The container image to run, either one pushed to the project's registry or an external one.
* **Resources & Scaling.** CPU and memory per replica, and whether the replica count is fixed or autoscaled.
* **Networking.** The port the container listens on, whether it is publicly reachable, and how readiness is checked.
* **Environment & Secrets.** The configuration and credentials passed to the container.
* **Schedule. W**hen the service runs.

### Revisions and deploying

Every deploy creates a revision. The panel on the left lists them, with the live one marked Deployed and everything before it Superseded. Compare Revisions shows what changed between any two, and Go to logs opens the Logs page with this database already selected. See [Logs](/governance/logs.md) under Governance.

Editing a service edits what is running. There is no draft state the way there is for an agent, so Deploy changes takes effect immediately. The safety net is revisions rather than drafts: deploy, then compare or roll back if the change misbehaves. Restart cycles the service without touching its configuration.

<div data-with-frame="true"><figure><img src="/files/GnCmhzKDRUI8Hqf0WN6V" alt=""><figcaption></figcaption></figure></div>

Open an older revision and the view goes read-only, offering Restore and deploy instead. Restoring promotes that revision's image, environment, secrets, and schedule back to the live configuration.

{% hint style="warning" %}
Whether you can deploy depends on your role in the project. Without the permission the configuration is readable but not editable, and project roles are managed from the organization level.
{% endhint %}

### Replicas

Replicas is read-only. Each replica shows its status, age, and requested CPU and memory, and opening one gives diagnostics: restart count, limits, health check state, last termination, and recent events. That is where you look when a service is unhealthy and you need to know whether it crashed, was killed, or never started.

{% hint style="info" %}
Services can also be managed from the command line, including declaratively from a stack file. See the [CLI documentation](https://docs.interactive.ai/cli/) for `iai services`.
{% endhint %}


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.interactive.ai/infrastructure/services.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.