diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..9c14461
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,3 @@
+# documentation
+.tox
+docs/_build/
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644
index 0000000..095222a
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,16 @@
+---
+version: 2
+
+formats:
+  - htmlzip
+
+build:
+  image: latest
+
+python:
+  version: 3.7
+  install:
+    - requirements: docs/requirements-docs.txt
+
+sphinx:
+  configuration: docs/conf.py
diff --git a/docs/conf.py b/docs/conf.py
index d96be56..50de2d8 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -19,5 +19,7 @@
 from docs_conf.conf import *
 
 linkcheck_ignore = [
-      'http://localhost',
+    'http://localhost.*',
+    'http://127.0.0.1.*',
+    'https://gerrit.o-ran-sc.org.*'
 ]