synth.download/readme.md

# synth.download
### server configs

---

this repository contains all of the server configs for synth.download. everything we run here that we *can* show off, will be put and updated here for others to use for their own configurations and setups if preferred.

our setups mainly consists of doing everything with containers (in docker) running on debian as the host. there may be some exceptions, but in almost all cases whenever preferred, we'll be using containers to deploy our services.

hosted is provided by [lua](https://foxgirl.dev)! 💚

synth.download's services consists of **4** different virtual machines:

- `phosphorus`
    - runs on the amd-based server! this one runs all of our fediverse services, pds and any other relatively heavy services that need some power.
- `neptunium`
    - runs on the intel-based server! this one runs our (shared(?? maybe?)) xmpp server (powered by [ejabberd](https://www.ejabberd.im)) and mailserver (powered by [mailu](https://mailu.io)).
- `cerium`
    - also runs on the intel-based server! this vm runs everything that isn't exactly considered "important". this may include things such as:
        - alternative frontends
        - static websites (including the synth.download homepage!)
        - and any other services and other related things.
    - meant to be self-maintained and automated so we don't have to keep an eye on it at all times and not worry about it.
        - **WIP:** maybe integrate with neptunium? unsure how that would be possible if we still want to keep this "stable"
- `synthnix`
    - our pubnix vm for our tilde members. runs on the intel-based server, kept relatively quiet.

and as for other things:

- [`Caddyfile`](./Caddyfile)
    - the "main" caddyfile that serves everything from all of our vms and configs to one.
- [`notes.md`](./notes.md)
    - personal notes/knowledge base while setting things up, may contain useful information for others.
- [`helperbot`](./helperbot)
    - our all-in-one helper script/utility for managing all of our vms. including vacuuming, cleanup, upgrading and backups. owo

feel free to look at them! we share our configs for everyone to use.

## todo

- [ ] ***very important,*** at least upload our current setup and clean them up as much as possible
- [ ] make a clean (as best as possible, anyways) all-in-one helper script/utility instead of having our (current) mess of seperate scripts
- [ ] figure out how to do a tilde configuration with how the setup is going to be
    - might be possible to do entirely with caddy? if not using something else is fine