town/docs/setup.md

setup

1. log into the vps, make sure it's fedora (or else 🔪)
2. create a new admin user
   • sudo useradd -m -G wheel admin
   • sudo passwd admin
   • sudo su - admin
3. use the system setup script, and log out
   • sudo dnf install git -y
   • git clone https://git.atom.town/atom/town && mv town atom.town
   • ./atom.town/scripts/system-setup.sh
   • exit
4. log in again, populate the .env and start everything up
   • cd atom.town
   • micro .env
   • docker compose up
5. continue with service-specific setups .....

services

specifics for everything

currently serving

• via docker
  • caddy – http server & reverse proxy
  • stalwart – mailserver
  • bulwark – webmail
  • gitea – git server
• via caddy
  • atom.town - homepage
  • post.atom.town – mailserver, mail admin, and oidc
  • mail.atom.town – webmail
  • git.atom.town – git

dns setup

type	host	value	notes
A	@	<ip>	apex domain
A	post	<ip>	mailserver
A	mail	<ip>	webmail
A	git	<ip>	gitea
CAA	@	0 issue "letsencrypt.org"	allow caddy to issue certs
MX	@	post.atom.town. / 10	mail record