Skip to main content

Development Environment Setup

This guide covers the necessary configuration to work on the Vania Novikau project, specifically focusing on backend connectivity.

1. Network Connectivity (Tailscale)​

The project relies heavily on Tailscale for secure internal communication between the WordPress server, AI services, and Databases.

  • AI Server IP: 100.115.246.57
  • Remote Host IPv4: <remote_host>
  • Tailscale Internal IP: 100.x.x.x (Use tailscale ip to check).

2. SSH Tunnels​

To enable the WordPress plugin to communicate with backend services, SSH tunnels must be active. Failure to maintain these tunnels results in Connection Refused errors on ports 5678 and 5435.

Tunnel Configuration​

Tunnels should be established with ServerAliveInterval to prevent timeouts.

Ports:

  • 5678: AI Service / Webhook Endpoint.
  • 5435: Database Connection.

Verification command:

curl -v http://127.0.0.1:5678/
# or use the custom script
php test_tunnels_web.php

3. Local Development (VS Code)​

Web Server (Docusaurus)​

  • Start Command: npm run docs:start
  • Binding: Binds to 0.0.0.0 to allow VS Code Port Forwarding (accessible externally).
  • Url: http://localhost:3000

Editor Configuration​

  • Root Directory: <local_root>
  • Docs Directory: <local_root>/documentation

4. Troubleshooting Access​

If you encounter ChunkLoadError or "Unable to Connect":

  1. Ensure the server is bound to 0.0.0.0 (not just localhost).
  2. Check VS Code "Ports" view to ensure Port 3000 is forwarded.
  3. If accessing the production docs, ensure your IP is whitelisted (see Operations).