# Tangled Containers

Container images for the [Tangled][] knot and spindle servers. All tagged
versions of `@tangled.org/core` are supported, as well as directly from the
`master` branch.

## Usage

Start a Knot Server:

```sh
docker run --name knot -e KNOT_SERVER_HOSTNAME=example.com -e KNOT_SERVER_OWNER=did:plc:yourdidgoeshere tubbo/knot
```

Start a Spindle Server:

```sh
docker run --name spindle -e SPINDLE_SERVER_HOSTNAME=example.com -e SPINDLE_SERVER_OWNER=did:plc:yourdidgoeshere tubbo/spindle
```

### Supported tags

- `latest` for the most recently tagged version
- `v1.x.x-alpha` to specify the tag
- `edge` to use the most recent Git commit to `master`

## Development

Images are built with [Docker Bake][], using [mise][] as a task runner and
toolchain installer.

To contribute to this repository, clone it from Tangled:

```sh
git clone https://tangled.org/@psychedeli.ca/tangled-containers
cd tangled-containers
```

Install dependencies with [mise][]:

```sh
mise install
```

Then, build the most recent images by running:

```sh
mise build
```

[Tangled]: https://tangled.org
[Docker Bake]: https://docs.docker.com/build/bake/
[mise]: https://mise.jdx.dev