diff --git a/shadowvpn/README.md b/shadowvpn/README.md
new file mode 100644
index 0000000..ee884de
--- /dev/null
+++ b/shadowvpn/README.md
@@ -0,0 +1,40 @@
+[`ShadowVPN`][1] is a fast, safe VPN based on libsodium.
+
+## directory tree
+
+```
+~/fig/shadowvpn/
+.
+├── docker-compose.yml
+└── shadowvpn/
+    ├── server.conf
+    ├── server_down.sh
+    └── server_up.sh
+```
+
+## docker-compose.yml
+
+```
+shadowvpn:
+  image: vimagick/shadowvpn
+  ports:
+    - "1123:1123/udp"
+  volumes:
+    - "shadowvpn:/etc/shadowvpn"
+  privileged: true
+  restart: always
+```
+
+## server
+
+```
+$ docker-compose up -d
+```
+
+## client
+
+```
+$ shadowvpn -c /etc/shadowvpn/client.conf -v
+```
+
+[1]: https://shadowvpn.org/