synth.download/readme.md

# synth.download

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.

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

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

- [`phosphorus`](./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.
        - serves all of our fediverse instances, and the bluesky pds
- [`neptunium`](./neptunium)
    - runs on the intel-based server! this one runs some of our shared services with other members and related services don't usually don't need much power, along with more "important" and "sensitive" things.
        - serves smaller/critical services such as xmpp, vaultwarden, forgejo, mail, etc...
        - also serves as the main caddy machine (static sites, etc)
        - ...and also serves various other *tiny* services like alternative frontends

and as for other things:

- [`notes`](./notes)
    - 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
- [`.old`](./.old)
    - configurations related to our older setup before migrating to our new servers/new configurations. kept for archival purposes, and may be useful to some.

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
    - [ ] experiment with using [age](https://github.com/FiloSottile/age) for backups
- [ ] 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
readme formatting 2025-07-03 00:52:31 -05:00			`# synth.download`
readme formatting 2025-07-03 00:49:33 -05:00
inital commit 2025-07-03 00:43:47 -05:00			`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.`

flesh out the readme some more 2025-07-03 01:10:42 -05:00			`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.`

update vm planning 2025-07-31 00:22:14 -05:00			`hosting is provided by [lua](https://foxgirl.dev)! 💚 [donate!](https://foxgirl.dev/tip/)`
inital commit 2025-07-03 00:43:47 -05:00
update vm planning 2025-07-31 00:22:14 -05:00			`synth.download's services currently consists of 2 different virtual machines:`
inital commit 2025-07-03 00:43:47 -05:00
update readme 2025-07-03 01:13:07 -05:00			- [`phosphorus`](./phosphorus)
inital commit 2025-07-03 00:43:47 -05:00			`- 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.`
some updates, cleanup, fix helperbot b2 upload step 2025-07-17 00:25:14 -05:00			`- serves all of our fediverse instances, and the bluesky pds`
update readme 2025-07-03 01:13:07 -05:00			- [`neptunium`](./neptunium)
update helperbot script (heavy wip) 2025-07-04 22:45:05 -05:00			`- runs on the intel-based server! this one runs some of our shared services with other members and related services don't usually don't need much power, along with more "important" and "sensitive" things.`
some updates, cleanup, fix helperbot b2 upload step 2025-07-17 00:25:14 -05:00			`- serves smaller/critical services such as xmpp, vaultwarden, forgejo, mail, etc...`
update planning 2025-07-03 14:30:29 -05:00			`- also serves as the main caddy machine (static sites, etc)`
update vm planning 2025-07-31 00:22:14 -05:00			`- ...and also serves various other tiny services like alternative frontends`

flesh out the readme some more 2025-07-03 01:10:42 -05:00			`and as for other things:`

update vm planning 2025-07-31 00:22:14 -05:00			- [`notes`](./notes)
flesh out the readme some more 2025-07-03 01:10:42 -05:00			`- 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`
add reworked caddy configs from current setup 2025-07-12 00:09:31 -05:00			- [`.old`](./.old)
			`- configurations related to our older setup before migrating to our new servers/new configurations. kept for archival purposes, and may be useful to some.`
flesh out the readme some more 2025-07-03 01:10:42 -05:00
inital commit 2025-07-03 00:43:47 -05:00			`feel free to look at them! we share our configs for everyone to use.`

			`## todo`

update todo 2025-07-03 00:54:51 -05:00			`- [ ] *very important,* at least upload our current setup and clean them up as much as possible`
readme formatting 2025-07-03 00:49:33 -05:00			`- [ ] make a clean (as best as possible, anyways) all-in-one helper script/utility instead of having our (current) mess of seperate scripts`
update todo 2025-07-06 22:52:47 -05:00			`- [ ] experiment with using [age](https://github.com/FiloSottile/age) for backups`
readme formatting 2025-07-03 00:49:33 -05:00			`- [ ] figure out how to do a tilde configuration with how the setup is going to be`
inital commit 2025-07-03 00:43:47 -05:00			`- might be possible to do entirely with caddy? if not using something else is fine`