domain-watchdog/INSTALL.md

Installation and Update

Installation

To deploy a Domain Watchdog instance, please refer to the Symfony documentation on How to deploy a Symfony application.

Prerequisites

• PHP 8.2 or higher
• PostgreSQL

In order to retrieve information about domain names, Domain Watchdog will query the RDAP server responsible for the TLD. It is crucial that the Domain Watchdog instance is placed in a clean environment from which these servers can be queried. In particular, the DNS servers and root certificates of the system must be trusted.

Steps

Clone the repository:

git clone https://github.com/maelgangloff/domain-watchdog.git

Backend

1. Install dependencies:

   composer install
   

2. Set up your environment variables:

   cp .env .env.local
   

3. Generate the cryptographic key pair for the JWT signature

   php bin/console lexik:jwt:generate-keypair
   

4. Run database migrations:

   php bin/console doctrine:migrations:migrate
   

5. Start the Symfony server:

   symfony server:start
   

Frontend

1. Install dependencies:

   yarn install
   

2. Generate language files:

   yarn run ttag:po2json
   

3. Make the final build:

   yarn build
   

Update

Any updates are your responsibility. Make a backup of the data if necessary.

Fetch updates from the remote repository:

git pull origin master

Backend

1. Install dependencies:

   composer install
   

2. Run database migrations:

   php bin/console doctrine:migrations:migrate
   

3. Clearing the Symfony cache:

   php bin/console cache:clear
   

Frontend

1. Install dependencies:

   yarn install
   

2. Generate language files:

   yarn run ttag:po2json
   

3. Make the final build:

   yarn build