---
title: Service
order: 4
description: "A long-running or shared process magus manages across runs, distinct from a one-shot target."
tags: [glossary, execution-and-caching]
---

# Service

A long-running or shared process magus manages across runs, distinct from a
one-shot target.

## Elsewhere

A systemd service is any unit the init system supervises; a Kubernetes Service is a stable
network endpoint in front of pods; a Compose service is one container definition. A magus
service is a process magus starts for targets and keeps across runs.

## Example

`magus broker status` lists the services the broker keeps warm.

```sh
magus broker status
```

## Used in

<!-- BEGIN GLOSSARY USAGE (generated by glossary-usage-generate from the knowledge graph; edit the generator, not this list) -->

In the docs:

- [A service reached via needs is supervised, not foregrounded](../concepts/dependencies.md#a-service-reached-via-needs-is-supervised-not-foregrounded)
- [An operation is a command or a service](../concepts/spells.md#an-operation-is-a-command-or-a-service)
- [ActivityService](../reference/api/activity/v1alpha1/activity.md#activityservice)
- [GraphService](../reference/api/graph/v1alpha1/graph.md#graphservice)
- [InsightService](../reference/api/insight/v1alpha1/insight.md#insightservice)
- [JobService](../reference/api/job/v1alpha1/job.md#jobservice)

In the code (`magus refs <name>` lists every site):

- `magus-protodocs.service` (Go)
- `activity.Service` (Go)
- `graph.Service` (Go)
- `insight.Service` (Go)
- `job.Service` (Go)

<!-- END GLOSSARY USAGE -->

## See also

- [Services](../concepts/services.md)
- [Broker](broker.md)