# thingy!

some kind of hosting setup

## setup

log into the vps, make sure it's fedora (or else 🔪)

```
sudo dnf install git -y
git clone https://gitlab.com/futile/thingy
./thingy/set-up-system.sh
exit
```

```
ssh <user>@<ip>
cd thingy
micro .env
docker compose up
```

continue with service-specific setups .....

## services

specifics for everything

**currently serving**
- via docker
  - **caddy** – http server & reverse proxy
  - **stalwart** – mailserver
  - **bulwark** – webmail
- via caddy
  - `mail.yaoi.dog` – mail (server & admin dash)
  - `post.yaoi.dog` – mail (webmail)

**dns setup**

| type  | host   | value                       | notes                      |
|-------|--------|---------------------------- |----------------------------|
| `A`   | `@`    | `<ip>`                      | apex domain                |
| `A`   | `m`    | `<ip>`                      | mailserver                 |
| `A`   | `mail` | `<ip>`                      | webmail                    |
| `CAA` | `@`    | `0 issue "letsencrypt.org"` | allow caddy to issue certs |

### stalwart

**first setup**
- server identity
  - server hostname: `mail.yaoi.dog`
  - default email domain: `yaoi.dog`
  - automatically obtain tls certificate: `true`
  - generate email signing keys: `true`
- storage
  - main data storage: `rocksdb`
  - path: `/var/lib/stalwart/`
- account directory
  - directory type: `use internal`
- logging
  - log destination: `console`
- automatic dns management
  - dns server type: `porkbun`
  - description: `porkbun`

**further setup**
- settings -> security -> allowed ips
  - added `172.18.0.0/24`; reason: `internal`
- settings -> network -> http -> security
  - permissive cors policy: `true`   **[restart needed]**

**notes**
- in [docker-compose.yml](docker-compose.yml), a `stalwart-logs` volume is currently defined but not being used, due to the fact that stalwart does not seem to create anything within it. i need to figure out why. for now, stalwart logs to console.

**useful links**
- https://stalw.art/docs/install/platform/docker/
- https://stalw.art/docs/install/security/
- https://stalw.art/docs/server/reverse-proxy/caddy/
- https://stalw.art/docs/telemetry/tracing/log/
- https://testconnectivity.microsoft.com/tests/Imap/input
- https://mail-tester.com/

### bulwark

**useful links**
- https://bulwarkmail.org/docs/deployment/docker
- https://bulwarkmail.org/docs/guides/admin
- https://bulwarkmail.org/docs/getting-started/configuration/environment-reference