diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c3fb5b2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,49 @@
+
+# Linux scripts
+
+These a my personal scripts to automate stuff related to linux/unix environment.
+
+
+## Documentation
+
+### setup-linux.sh
+
+Allows basic setup of your debian/fedora/arch system with all the basic packages for everyday usage.
+
+Includes general tools, browser, everyday apps, gaming related apps, virtualization/container packages, remote access, u2f (yubico), terminal/shell, development environment, openrazer.
+
+### setup-distrobox.sh
+
+Install preconfigured arch, debian and fedora containers for development
+
+
+## Roadmap
+
+- Add desktop/server/minimal setup to setup-linux.sh
+
+- Add more interactions to setup-linux.sh
+
+- Add Desktop (gnome/kde/xfce/lxqt...) setup script
+
+- Add GPU driver setup
+
+- Add Jetbrain setup
+
+
+## Contributing
+
+Contributions are always welcome!
+
+Open a pull request and we'll discuss on integration of your script or fixes.
+
+
+## FAQ
+
+#### What are these scripts for?
+
+Automating task on most *NIX environment such as desktop or server setup
+
+#### I found an issue what should I do?
+
+Open an issue with all needed informations so we can fix it or pull request if you found how to fix it.
+