Exit Documentation
Edit

How to create a subdomain?

Learn how to register and manage custom Discloud subdomains for your applications.

🌐 What is a Discloud Subdomain?

On Discloud, any app that uses a port and requires external access through it to be accessed is considered a site. This includes bots with dashboards, dashboards, APIs, static and dynamic sites, and many others…

To allow external access to your app, Discloud offers the option to create a custom subdomain. This subdomain redirects traffic through the Discloud proxy to port 8080 of your app, allowing you and users to access your site securely and reliably.

📡 How it Works

Discloud subdomain flow

✅ Requirements

To register and use a Discloud subdomain, you must meet the following requirements:

Platinum Plan or Higher is required to host websites or APIs.

Port 8080 – Your application must listen on port 8080 for external traffic

Discloud Config – Your app must include a properly configured discloud.config file

🚀 Register Your Subdomain

1

Open the Discloud Dashboard.

2

Click on the Subdomain tab at the top of the application page.

Dashboard Subdomain tab
3

Click the + Subdomain button to create a new subdomain.

Add Subdomain button
4

Enter your desired subdomain name (e.g., myapp, dashboard, api).

Subdomain naming rules

  • Maximum 20 characters

  • Only alphanumeric characters (A–Z, 0–9) and hyphens (-)

  • No spaces, underscores, or special characters allowed

5

Your subdomain is now registered and its state will show as Available.

📝 Configure Your discloud.config

Once your subdomain is registered, you must add it to your discloud.config file so Discloud routes traffic to the correct app.

Open your discloud.config file and locate the ID field:

ID=yoursubdomain

How to specify the subdomain in the discloud.config file?

Use only the subdomain name, not the full domain (e.g., use myapp, not myapp.discloud.app).

Example:

discloud.config
ID=myapp
TYPE=site

After updating discloud.config, deploy your application for the changes to take effect.

How to Host, Using

🔄 Subdomain States

Your registered subdomain can have two states:

🔵 Active

  • The subdomain is registered and in use.

  • An app is currently deployed and accessible at https://yoursubdomain.discloud.app.

  • Traffic is being routed to your app on port 8080.

🟢 Available

  • The subdomain is registered and available.

  • No app is currently using it.

  • You can deploy an app to activate it at any time.

🌍 Access Your Site

Once your subdomain is Active, you can access it via:

https://yoursubdomain.discloud.app

⚙️ Custom Domain

If you want to use your own domain (e.g., yourdomaind.com) instead of a Discloud subdomain, check:

Custom Domain
PreviousWhat is the root of the project?NextHow to build and package a Java application?

Last updated