# RecapTime.dev Knot Server on Nest

[![pipeline status](https://gitlab.com/recaptime-dev/infra/knot-server-docker/badges/recaptime-dev/main/pipeline.svg)](https://gitlab.com/recaptime-dev/infra/knot-server-docker/-/commits/recaptime-dev/main)
[![Hack Club](https://badges.api.lorebooks.wiki/badges/hackclub/hackclub)](https://hackclub.com)

Sources for the container images of Tangled Knot server, used to run `knot.hackclub.community` at an Azure VM (previously on [Nest tilde server before going with Promox VM-based containers](https://hackclub.app)).

## Usage

On the repository creation page, select `knot.hackclub.community` as the Knot server.
When cloning or adding/updating remote URLs, use the following SSH Git URLs below as documented:

```bash
# on its custom domain
git remote add origin ssh://git@knot.hackclub.community:33939/handle.host.tld/repo

# directly with our proxyparty server's hostname (since it's just a CNAME DNS record)
git remote add origin ssh://git@proxyparty.recaptime.dev:33939/handle.host.tld/repo
```

### Infrastructure Operations

* Image CI builds happen via GitLab CI: <https://gitlab.com/recaptime-dev/infra/knot-server-docker/pipelines>
  * [View our GitLab CI config](./.gitlab-ci.yaml)
  * [View tags on GitLab Container Registry](https://gitlab.com/recaptime-dev/infra/knot-server-docker/container_registry/9481789)
* Run using built images after `ssh recaptime-dev@hackclub.app`: `<docker|podman> compose up --no-build --force-recreate`
* Get build information: `<docker|podman> compose exec knot knotserver-version`

## Requesting access

> You'll be asked for your AT Proto handle/DID PLC to provision access. Don't have one?
> You can sign up via [Bluesky Social](https://bsky.app) or in [Tangled](https://tangled.org/signup)
> directly.

Hack Clubbers can request access for `knot.hackclub.community` by contacting Andrei Jiroh in the Slack, either
[via DMs](https://hackclub.slack.com/team/U07CAPBB9B5) or at the
[main `#recaptime-dev` Slack channel](https://hackclub.slack.com/archives/C07H1R2PW9W).

## Docs

* [Usage terms](./docs/terms.md)
* [Donate to keep this running](./docs/donate.md)
* [Knot hosting guide](https://tangled.org/tangled.org/core/blob/main/docs/knot-hosting.md)
* [Upstream repository README](https://tangled.org/tangled.org/knot-docker/blob/main/readme.md)

## License

MIT