From 3b15eaa0f77efd4fb7b906bfed7a4861883728c9 Mon Sep 17 00:00:00 2001 From: Anton Prokhorov Date: Tue, 30 Jul 2024 22:31:03 +0100 Subject: [PATCH] Finished server setup docs --- docs/docs/install/server.md | 35 +++++++++++++++++++++++++++++++++-- 1 file changed, 33 insertions(+), 2 deletions(-) diff --git a/docs/docs/install/server.md b/docs/docs/install/server.md index 5beb5ab..66c988d 100644 --- a/docs/docs/install/server.md +++ b/docs/docs/install/server.md @@ -13,10 +13,41 @@ To install the Sonar Server, you must have: - A Linux server with a public IP address (``) and Docker and Docker Compose installed. - A registered domain name (``). -## Docker compose file +## DNS configuration + +In order for Sonar to work, it must be configured to act as a nameserver for ``. +To do this, go to your domain registrar's control panel and add a new nameserver with the domain +name `ns.` and the IP address ``, then add an `NS` record for your `` pointing to +the created nameserver, i.e. `ns.`. + + +:::info + +Let's say you have the domain `example.com` and a server with the public IP address `123.123.123.123`. +In the registrar's control panel you must add a new nameserver `ns.example.com` with IP address `123.123.123.123`. +Then, you need to add an `NS` record for `example.com`: + +| example.com | record type | value | +| - | - | - | +| @ | NS | ns.example.com | + +::: + +To ensure that everything is configured correctly, you can use the following commands: + +``` +$ host -t ns + name server ns.. + +$ host -t a ns. +ns. has address +``` + + +## Docker compose The recommended way to install the Sonar backend on your server is to use a Docker Compose file. -Create a `docker-compose.yml' file on your server with the following content: +Create a `docker-compose.yml` file on your server with the following content: ```yml title="docker-compose.yml" services: