### CLI
* [Full CLI command documentation](https://github.com/sonata-nfv/son-emu/wiki/CLI-Command-Overview)
+
+### Vagrant VM creation
+A Vagrantfile allows to automatically create and provision a VM in which son-emu is installed and ready to be used.
+
+* `cd ~/son-emu`
+* `vagrant up`
+* `vagrant ssh` to enter the new VM in which the emulator is installed.
--- /dev/null
+************************************************************
+** Welcome to SONATA's son-emu VM **
+** http://sonata-nfv.eu **
+** **
+** To run the emulator with a simple example topology **
+** and its fake-gatekeeper run the following commands. **
+** **
+** Switch to example folder: **
+** - cd son-emu/src/emuvim/examples **
+** **
+** Start the emulator with SONATA's example topology: **
+** - sudo python sonata_y1_demo_topology_1.py **
+** **
+** The emulator will be started and the fake-gatekeeper **
+** API will be accessible on port 5000 from both, the **
+** VM and your host machine. **
+************************************************************
\ No newline at end of file