diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..35938dd
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,24 @@
+# Go Password
+
+
+A password generator written in Go as a test, replaces the old node based password generator
+
+
+
+To build:
+
+```shell
+
+ $ go build -ldflags "-s -w"
+ 
+```
+
+This will build a smaller executable, then do:
+
+```shell
+
+ $ sudo cp password /usr/bin/password-gen
+
+```
+
+To copy it into the executable store
\ No newline at end of file