inital version

README.md

@@ -1,2 +1,52 @@
-# compose-vscode
+# Basic VS Code Server docker-compose config
+* can be run on single node setup or in swarm  
 
+## howto
+### single node
+#### start container
+```bash
+docker compose up -d
+```
+
+#### stop container (and remove)
+```bash
+docker compose down
+```
+
+#### view logs
+```bash
+docker compose logs -f
+```
+
+#### reload config
+```bash
+docker compose restart
+```
+
+### swarm
+#### start aka deploy
+```bash
+docker stack deploy -c docker-compose.yml vscode
+```
+
+#### stop container aka service
+```bash
+docker service rm vscode_vscode
+```
+
+#### view logs
+```bash
+docker service logs vscode_vscode -f
+```
+
+#### reload config (no downtime if replica 2 or more)
+```bash
+docker service update vscode_vscode --force
+```
+
+## example caddy config
+```
+code.example.com {
+    reverse_proxy vscode:8443
+}
+```