ToolJet

Accessing ToolJet

1. Visit: https://<SERVER-IP>/
2. Accept SSL warning (self-signed certificate).
3. On first access, ToolJet will prompt you to create the initial admin account.

Important Files and Directories

• ToolJet main installation directory: /root/tooljet
• Environment variables (database, secrets, app config): /root/tooljet/.env
• Docker Compose configuration: /root/tooljet/docker-compose.yaml
• PostgreSQL persistent data: /root/tooljet/postgres_data
• Nginx TLS certificates (self-signed): /etc/nginx/ssl/
• Nginx site configuration: /etc/nginx/sites-available/tooljet

Enabling SSL with a Domain

1. Point your domain to the server IP.

2. Edit the /root/tooljet/.env file to set your domain name: TOOLJET_HOST=https://your.domain.com

3. Recreate the services:

cd /root/tooljet/
docker compose up -d

4. Edit Nginx config and replace both server_name <IP>; with your domain (<your-domain>) for both HTTP (port 80) and HTTPS (port 443) blocks:

vim /etc/nginx/sites-available/tooljet

5. Install Certbot:

apt install -y certbot python3-certbot-nginx

6. Run the following command to generate a valid Let’s Encrypt certificate:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

7. Replace SSL paths in Nginx config (TLS section):

vim /etc/nginx/sites-available/tooljet
# Before:
    # ssl_certificate /etc/nginx/ssl/fullchain.pem;
    # ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

8. Restart Nginx to apply the changes:

systemctl restart nginx

9. Open your browser and visit: https://yourdomain.com