Javascript

Complete guide to host JavaScript applications on Discloud.

📁 Preparing the Files

Before uploading your project, you must exclude unnecessary files to optimize the deployment.

❌ Files to Exclude

Ensure the following files and directories are not included in your .zip:

- package-lock.json
- node_modules/
- .cache/
- .git/

📌 Use a .discloudignore file to automatically exclude these files.

🔗 Need help setting up your package.json or find main file?

📦 About the dist folder (TYPE=site only)

For apps with TYPE=site, the dist/ folder is reserved for BUILD output. If you set BUILD=... in your discloud.config, we generate the dist/ folder for you. Do not compress dist/ or upload files into it.

⚙️ Automatic build

Add BUILD in discloud.config (e.g., BUILD=npm run build).
Your build script outputs files to dist/ (Vite, Vue, etc. already do this).
We run BUILD before START and serve the dist/ folder.

Example:

TYPE=site
MAIN=server/index.js
BUILD=npm run build
START=npm run start
RAM=512
VERSION=latest
ID=mysite

👜 Pre-built

Produce output in build/ (do not use dist/).
Omit BUILD from discloud.config.
Point MAIN to the build/ folder.

Example:

TYPE=site
MAIN=build/server.js
RAM=512
VERSION=latest
ID=mysite

🌐 Hosting Websites & APIs with Express

Before deploying your website or API on Discloud, ensure that you meet the following requirements:

Platinum plan or higher is required to host websites or APIs.

A subdomain must be created before deployment.

Port 8080 is mandatory – Applications must listen on this port.

⚙️ Configuring Express

const express = require("express");
const app = express();

app.get("/", (req, res) => {
    res.send("Hello, Discloud!");
});

const PORT = process.env.PORT || 8080;
app.listen(PORT, () => console.log(`Server running on port ${PORT}`));