> Index of every page on this site: [llms.txt](https://docs.a-line.cloud/llms.txt)

# Project file

> A project (Kubernetes namespace) with its applications.

Schema definition: `ProjectFile`.

## Example

A minimal `projects/<project>/project.yaml`, with the file it refers to first:

```yaml title="clusters/hetzner-fsn1.yaml" iac
# yaml-language-server: $schema=https://a-line.cloud/schemas/iac/v1.json
version: 1
provider: hetzner
region: fsn1
pools:
  - name: control-plane
    role: control_plane
  - name: general
```

```yaml title="projects/web/project.yaml" iac
# yaml-language-server: $schema=https://a-line.cloud/schemas/iac/v1.json
version: 1
name: web
cluster: hetzner-fsn1
```

## Fields

### `apps`

Type: list of [`AppSpec`](/iac/reference/types#appspec), optional, default `[]`.

Applications in this project.

### `buckets`

Type: list of [`BucketSpec`](/iac/reference/types#bucketspec), optional.

Managed buckets this project's link manages. Leaving the key out
leaves every bucket as it is; a present list is authoritative for the buckets
the link owns (an entry removed from it stops being managed).

### `cluster`

Type: `string`, optional.

The cluster the project runs on (a `clusters/<name>.yaml` stem or a
cluster the tenant already has). Required on create when clusters
are known; fixed while the project has apps.

### `display_name`

Type: `string`, optional.

Human-readable display name.

### `egress`

Type: [`EgressSpec`](/iac/reference/types#egressspec), optional.

Outbound mode and allowlist. Leaving the key out leaves the stored
settings alone; a present mapping replaces them (no `mode` means `public`).

### `isolated`

Type: `boolean`, optional.

Whether the project's apps are isolated from each other. Leaving the
key out leaves the project as it is; a value switches it. Exported
only when `true`.

### `name`

Type: `string`, required.

Project name (becomes the k8s namespace).

### `network_policies`

Type: list of [`NetworkPolicySpec`](/iac/reference/types#networkpolicyspec), optional.

Network policies: connections from this project to other projects
of the cluster. Leaving the key out leaves the stored connections
alone; `[]` removes them all.

### `quotas`

Type: [`QuotaSettings`](/iac/reference/types#quotasettings), optional.

The project's quota limits. Leaving the key out leaves the stored
limits alone; `{}` removes them all.

### `storages`

Type: list of [`StorageSpec`](/iac/reference/types#storagespec), optional.

External storage connections this project's link manages (same
rules as `buckets`).

### `version`

Type: [`SchemaVersion`](/iac/reference/types#schemaversion), required.

The IaC schema version this file is written for.
