Troubleshooting

🔐 SFTP connection error

Check:

• sftp_host must be an IP address
• correct username/password
• port availability
• timeouts (SFTP_*_TIMEOUT)

In Admin use Test Connection.

🚫 Route already exists

The route already exists:

• in DB (Landing with same domain and route)
• on the server (directory already created)

Choose a new route or remove the directory manually.

🧾 Deployment finished but no link

Check:

• whether Celery worker is running
• status in Deployments
• deployment logs (SFTP errors/permissions)

🔄 Service worker not updating

worker.js is uploaded only if missing.
To update it — delete the file on the server.

📦 XLSX import errors

Ensure the file has columns:

• domain, sftp_host, sftp_port, sftp_username, sftp_password, notes

🔁 URL transfer does not work

Check:

• the domain exists in the system
• the route actually exists on the server

🎨 Template variables not substituted

Ensure:

• variable name is correct
• Template HTML / ButtonsContainer HTML includes the placeholders