# Services

{% hint style="info" %}
The **Services** menu is only available to Docker Swarm endpoints.
{% endhint %}

A service consists of an image definition and container configuration as well as instructions on how those containers will be deployed across a Swarm cluster.

<figure><img src="/files/nrB7nknYY1QGjm9gPA4G" alt=""><figcaption></figcaption></figure>

When the [new image indicator](/user/docker/swarm/setup.md#other) feature is enabled, the **Images up to date** column indicates whether the local images in the service are up to date, with a green tick indicating they are up to date and an orange cross indicating that there is a newer version of an image available at the remote registry. A grey hyphen indicates Portainer was unable to determine whether there is an update available for the images.

You can click the **Reload image indicators** button to recheck the images for all your services for updates, or to recheck a single service's images you can click the image indicator icon for that service.

For more on how this works, have a look at [this article](/faqs/troubleshooting/stacks-deployments-and-updates/how-does-the-image-update-notification-icon-work.md).

{% content-ref url="/pages/-Mgd0Qt1gsEfoHeNzion" %}
[Add a new service](/user/docker/services/add.md)
{% endcontent-ref %}

{% content-ref url="/pages/-Mgd1I2oOW2LGzn5mwEl" %}
[Configure service options](/user/docker/services/configure.md)
{% endcontent-ref %}

Once a service has been created you can scale it to meet your needs, as well as view individual task status and logs.

{% content-ref url="/pages/-MiK1Cdjg4X0om0BpmbL" %}
[Scale a service](/user/docker/services/scale.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MiK1eRbHysYJpjZeCzg" %}
[View the status of a service task](/user/docker/services/tasks.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MiK1PdOLA\_NCAiqEmeE" %}
[View service logs](/user/docker/services/logs.md)
{% endcontent-ref %}

If you need to undo some changes to a service, you can roll it back.

{% content-ref url="/pages/-MiK2-wy13B488O59tu6" %}
[Roll back a service](/user/docker/services/rollback.md)
{% endcontent-ref %}

You can also configure webhooks for your services.

{% content-ref url="/pages/-Mhunl4gOKcnIYGkKRW\_" %}
[Webhooks](/user/docker/services/webhooks.md)
{% endcontent-ref %}


---

# Agent Instructions: 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.portainer.io/user/docker/services.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.
