diff --git a/Readme.md b/Readme.md
index f836cb0e0c4a71253a54d03188c1fda3cc358367..d21e0bd9a30b3436128cd1fdad8896971d33cfb3 100644
--- a/Readme.md
+++ b/Readme.md
@@ -26,6 +26,22 @@ The docker build process consists in three steps
 2. Create a build image that retrieve the unl2rdf parser sources and builds it
 3. Create an image to run the flask application
 
+## Update
+
+### Web sevice
+
+```
+git pull
+# rebuild should not be required most of the time
+docker-compose build
+docker-compose down
+docker-compose up
+```
+
+### UnlTool
+
+To update the unltool jar, first upde `GIT_REF` in the `.env` file, then run the previous update step with a rebuild (not optionnal)
+
 ### Triggering a rebuild
 
 Docker caches every step of the build, if the java parser has changed, `docker-compose build` will not detect it, so you have to change `GIT_REF=` in the `.env` file to point to the desired commit, branch or tag. Then you can run `docker-compose build` and only the required steps to rebuild the java parser will run again.