---
title: "alis service"
url: "https://docs.alisx.com/reference/cli/service/"
---
# alis service

Manage services: register a new one in a product, run one locally, or preview its frontend.

## Synopsis

```bash
alis service new <package-id> [flags]
alis service preview [<pkg>|<path>] [flags]
alis service run [<pkg>|<path>] [-- <args>...] [flags]
```

Aliases: `service`, `services`.

## Subcommands

### alis service new

Register a new service in a product, for example `alis service new acme.shop.users.v1`. The service is created on the platform, and its local working folders are created in whichever of the product's repos are already cloned: the service folder plus `infra/` in the build repo, and the service's proto folder in the define repo. Neither repo is cloned by this command, and no files are generated.

```bash
alis service new <package-id> [flags]
```

No flags beyond the [global flags](https://docs.alisx.com/reference/cli/index.md#global-flags). The JSON result carries `buildFolder` and `defineFolder`; use them for the following commands.

### alis service preview

Identical to [alis preview](https://docs.alisx.com/reference/cli/preview.md).

### alis service run

Identical to [alis run](https://docs.alisx.com/reference/cli/run.md).

## Examples

```bash title="Terminal"
alis service new acme.shop.users.v1 --json
alis service run acme.shop.users.v1
alis service preview --port 5173
```