diff --git a/.github/CI.md b/.github/CI.md
new file mode 100644
index 00000000000..1b2d03936fb
--- /dev/null
+++ b/.github/CI.md
@@ -0,0 +1,15 @@
+# Troubleshooting
+
+Sometimes the server-integrations stuck for a long while > 30 min. Usualy because test db connection closed unexpectedly.
+
+```java.net.SocketException: Socket closed```
+
+To restart action - select it in actions list
+
+https://github.com/ishgroup/oncourse/actions/workflows/server_test.yml
+
+Press 'Cancel workflow'
+Then after action really stopped rerun all jobs
+
+
+We need to understand why the problem occurs in the github actions environment, but not elsewhere. Perhaps some DB configuration change is needed.
diff --git a/.github/README.md b/.github/README.md
deleted file mode 100644
index 84057692f88..00000000000
--- a/.github/README.md
+++ /dev/null
@@ -1,14 +0,0 @@
-#troubleshooting
-
-Sometimes the server-integrations stuck for a long while > 30 min. Usualy because test db connection closed unexpectedly.
-
-`java.net.SocketException: Socket closed
-`
-To restart action - select it in actions list
-
-https://github.com/ishgroup/oncourse/actions/workflows/server_test.yml
-
-Press 'Cancel workflow'
-Then (after action really stopped) open menue and select rerun all jobs
-
-Important note: there are some correlation among actions that run in parrallel (for example few RP run integration tests in the same time)
\ No newline at end of file