Vibe Web Documentation

Connecting domain to custom deployer

These steps are only required if you prefer using custom deployer for hosting user sites instead of netlify.

Step 1 — Add Deploy Domain

  1. From the aaPanel sidebar, click Website.
  2. Click Add Site.
  3. Enter your domain:
deploy.yourdomain.com
  1. Click Confirm.

Image


Step 2 — Configure Reverse Proxy

  1. Click Conf next to deploy.yourdomain.com.
  2. A settings modal will open.
  3. Select Reverse Proxy.
  4. Click Add Reverse Proxy.

Image

Fill the fields as follows:

Target URL

http://localhost:3022

Sent Domain

$host

⚠️ Important:
The Sent Domain field must be $host. Double-check this before saving.

Image

Close the modal once completed.


Step 3 — Add Preview Domains

Click Add Site again and add the following two domains:

preview.yourdomain.com
*.preview.yourdomain.com

The wildcard domain:

*.preview.yourdomain.com

allows all user-created websites to connect to your server.

Click Confirm.

Image


Step 4 — Configure Reverse Proxy for Preview Domains

  1. Click Conf for the newly added preview domain.
  2. Open the Reverse Proxy tab.
  3. Click Add Reverse Proxy.

Enter the following:

Target URL

http://localhost:3022

Sent Domain

$host

⚠️ Again, make sure the Sent Domain field is $host.


Image

Step 5 — Enable SSL (Let's Encrypt)

  1. Inside the settings modal, open the left sidebar.
  2. Click SSL.
  3. Go to the Let's Encrypt tab.
  4. Select:
DNS Verification
  1. Choose:
Manual Add Record
  1. Select All domains.
  2. Click Apply.

aaPanel will display DNS records that you must add to your domain DNS settings.

Add those records and then continue verification.

Image


Step 6 — CAA Record (If Required)

You may see a CAA record requirement such as:

0 issue letsencrypt.org

If you need to add this record:

  • Flag field:

    0
    
  • Tag field:

    issue
    
  • Domain value:

    letsencrypt.org
    

If your DNS provider does not have a Tag field, use the default option provided by your DNS provider.


Setup Complete

Once SSL verification is completed and the reverse proxy is configured, your deployment server is fully ready.

Your Vibe Web system can now build, deploy, and host user-created websites automatically.