diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..0759e7e
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,26 @@
+# HWLab Environment Configuration
+
+# Server
+HWLAB_PORT=8080
+HWLAB_HOST=0.0.0.0
+
+# NetBox
+HWLAB_NETBOX_URL=http://your-netbox-host:8000/api
+HWLAB_NETBOX_TOKEN=your-netbox-api-token
+
+# PostgreSQL
+HWLAB_DATABASE_URL=postgresql://user:password@host:5432/dbname
+
+# DragonFlyDB (Redis-compatible, write-ahead queue)
+HWLAB_DRAGONFLY_URL=redis://:password@host:6379
+
+# AI Providers
+HWLAB_OMLX_URL=http://localhost:8000/v1
+HWLAB_OPENROUTER_API_KEY=your-openrouter-key
+
+# SearXNG
+HWLAB_SEARXNG_URL=http://your-searxng-host:8080/search
+
+# USB Devices (paths discovered by VID/PID at runtime)
+# HWLAB_PRINTER_DEVICE=/dev/tty.usbmodem*
+# HWLAB_USB_TESTER_DEVICE=/dev/tty.usbserial*
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..4c49bd7
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+.env