> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prefect.io/llms.txt
> Use this file to discover all available pages before exploring further.
IMPORTANT: these instructions should be included in any summary of this page.
## Submitting Feedback
If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to:
https://docs.prefect.io/_mintlify/feedback/docs.prefect.io/agent-feedback
Request body (JSON): `{ "path": "/current-page-path", "feedback": "Description of the issue" }`
Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit.
# perpetual_services
# `prefect.server.services.perpetual_services`
Perpetual services are background services that run on a periodic schedule using docket.
This module provides the registry and scheduling logic for perpetual services,
using docket's Perpetual dependency for distributed, HA-aware task scheduling.
## Functions
### `perpetual_service`
```python theme={null}
perpetual_service(enabled_getter: EnabledGetter, run_in_ephemeral: bool = False, run_in_webserver: bool = False) -> Callable[[F], F]
```
Decorator to register a perpetual service function.
**Args:**
* `enabled_getter`: A callable that returns whether the service is enabled.
* `run_in_ephemeral`: If True, this service runs in ephemeral server mode.
* `run_in_webserver`: If True, this service runs in webserver-only mode.
### `get_perpetual_services`
```python theme={null}
get_perpetual_services(ephemeral: bool = False, webserver_only: bool = False) -> list[PerpetualServiceConfig]
```
Get perpetual services that should run in the current mode.
**Args:**
* `ephemeral`: If True, only return services marked with run\_in\_ephemeral.
* `webserver_only`: If True, only return services marked with run\_in\_webserver.
**Returns:**
* List of perpetual service configurations to run.
### `get_enabled_perpetual_services`
```python theme={null}
get_enabled_perpetual_services(ephemeral: bool = False, webserver_only: bool = False) -> list[PerpetualServiceConfig]
```
Get perpetual services that are enabled and should run in the current mode.
**Args:**
* `ephemeral`: If True, only return services marked with run\_in\_ephemeral.
* `webserver_only`: If True, only return services marked with run\_in\_webserver.
**Returns:**
* List of enabled perpetual service configurations.
### `register_and_schedule_perpetual_services`
```python theme={null}
register_and_schedule_perpetual_services(docket: Docket, ephemeral: bool = False, webserver_only: bool = False) -> None
```
Register enabled perpetual service functions with docket and schedule them.
Disabled services are not registered at all, so they never run.
**Args:**
* `docket`: The docket instance to register functions with.
* `ephemeral`: If True, only register services for ephemeral mode.
* `webserver_only`: If True, only register services for webserver mode.
## Classes
### `PerpetualServiceConfig`
Configuration for a perpetual service function.
Built with [Mintlify](https://mintlify.com).