diff --git a/config.example.yaml b/config.example.yaml
new file mode 100644
index 00000000..2b21f2a3
--- /dev/null
+++ b/config.example.yaml
@@ -0,0 +1,15 @@
+# Minstrel example configuration.
+# Every field is optional; defaults shown below match Default() in internal/config.
+# Each setting can be overridden at runtime via SMARTMUSIC_* environment variables
+# (see internal/config/config.go for the full list).
+
+server:
+  address: ":4533"
+
+database:
+  # Postgres connection string, e.g. postgres://minstrel:minstrel@localhost:5432/minstrel?sslmode=disable
+  url: ""
+
+log:
+  level: "info"    # debug | info | warn | error
+  format: "text"   # text | json