Clone this repo:
  1. aa4b72e h/m/customs: migration from isc-dhcp4 to kea by Ari Gerus · 9 days ago master
  2. 1bcaa97 hswaw/checkinator: implement support for kea dhcp server by Ari Gerus · 10 days ago
  3. 0aec638 hswaw/machines/sound: spejsiot-polycom service, use full pulseaudio by Piotr Dobrowolski · 5 weeks ago
  4. 7b3a2f1 hswaw/machines/printmaster: bring back legacy content, labelmaker redirect by Piotr Dobrowolski · 3 weeks ago
  5. c1a8c2d app/matrix: bump synapse, riot, mediarepo, coturn... by Piotr Dobrowolski · 4 weeks ago

hscloud is the main monorepo of the Warsaw Hackerspace infrastructure code.

Getting started

See //doc/codelabs for tutorials on how to use hscloud.

If you want to browse the source of hscloud in a web browser, use cs.hackerspace.pl.

Initial setup: //doc/codelabs/getting-started/bazel-go.md

Initial bazel build for tools: bazelisk run //tools:install

For additional documentation go to //cluster

If you want some other help, talk to q3k, informatic or your therapist.

Directory Structure

Directories you should care about:

  • app: external services that we host that are somewhat universal: matrix, mastodon, etc.
  • bgpwtf: code related to our little ISP
  • cluster: code related to our Kubernetes cluster (k0.hswaw.net)
  • dc: code related to datacenter automation
  • devtools: code related to developer tooling, like gerrit or hackdoc
  • doc: high-level documentation that doesn't fit anywhere else, ie. codelabs
  • hswaw: Warsaw Hackerspace specific/internal services. The line between this and app is unfortunately blurry.
  • personal: user's personal (experimental) directories
  • kube, go: code specific to languages but general to the whole of hscloud

Licensing

Unless noted otherwise, code in hscloud is licensed under the BSD 0-clause license - see COPYING.