From 68e940986d94aa882dd27820deef19a9c3f1a79d Mon Sep 17 00:00:00 2001
From: "Max R. Carrara" <max@aequito.sh>
Date: Sat, 16 Aug 2025 15:04:06 +0200
Subject: [PATCH] readme: update readme

Signed-off-by: Max R. Carrara <max@aequito.sh>
---
 wien_talks/wien_talks_server/README.md | 38 ++++++++++++++++++--------
 1 file changed, 26 insertions(+), 12 deletions(-)

diff --git a/wien_talks/wien_talks_server/README.md b/wien_talks/wien_talks_server/README.md
index daddc21..e4d5962 100644
--- a/wien_talks/wien_talks_server/README.md
+++ b/wien_talks/wien_talks_server/README.md
@@ -1,29 +1,43 @@
 # wien_talks_server
 
-This is the starting point for your Serverpod server.
+## Local Development Environment
 
-To run your server, you first need to start Postgres and Redis. It's easiest to do with Docker.
+Setting up a local postgres container, run the following:
 
-    docker compose up --build --detach
+```bash
+make local
+```
 
-Then you can start the Serverpod server.
+This will first create an `.env` file with default values and then launch the
+container.
 
-    dart bin/main.dart
+You can then launch the Serverpod server like so:
 
-When you are finished, you can shut down Serverpod with `Ctrl-C`, then stop Postgres and Redis.
+```bash
+dart bin/main.dart
+```
 
-    docker compose stop
+If your database schema isn't initialized yet, you will have to run the
+following:
 
-## Environments & Passwords
+```bash
+dart bin/main.dart --apply-migrations
+```
 
-Note that the password used in your environment files (`.env` for local
-development and `env.d/postgres.env.template` for deployment) must correspond to
-the password in `config/passwords.yaml`.
+See the `Makefile` for all targets.
 
-The `config/passwords.yaml` file must be created manually, for example:
+## Passwords
+
+The password used in your environment files (`.env` for local development and
+`env.d/postgres.env.template` for deployment) must correspond to the password in
+`config/passwords.yaml`.
+
+The `config/passwords.yaml` file must be created manually at the moment; for
+example:
 
 ```yaml
 development:
   database: your-password-here
 ```
 
+