Skip to content

Conversation

@Abubakar-Meigag
Copy link

What does this change?

Adds step-by-step instructions for configuring NODE_ENV on all Node.js applications deployed to CYF Hosting.

Changes:

  • Added environment variable configuration guide to backend deployment docs
  • Added environment variable configuration guide to frontend deployment docs
  • Includes screenshots showing the Coolify UI workflow

Why this is important:

This configuration is now mandatory for all JavaScript/Node.js projects deployed to CYF Hosting. Without NODE_ENV, applications run in development mode with file watching enabled, consuming ~100x more system resources per container. This inefficiency led to infrastructure failures on January 28, 2026, when file descriptors were exhausted across 150+ deployments. Setting NODE_ENV ensures applications run efficiently and maintains hosting stability for all users.

Common Content?

  • Block/s = N/A

Common Theme?

  • No

Issue number: # Related to infrastructure incident on 2026-01-28

Org Content?

Guide | CYF Hosting | Deployment | Configuration

Checklist

Who needs to know about this?

@illicitonion

Adds instructions to set NODE_ENV=production for all Node.js applications to prevent resource exhaustion on the hosting infrastructure.

Changes:
- Added step-by-step guide for setting NODE_ENV environment variable
- Includes screenshots for clarity
- Applied to both backend and frontend deployment guides

This configuration is now mandatory for all JavaScript/Node.js projects to ensure applications run in production mode rather than development mode.
@netlify
Copy link

netlify bot commented Jan 29, 2026

👷 Deploy request for cyf-curriculum pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 93e1012

@netlify
Copy link

netlify bot commented Jan 29, 2026

👷 Deploy request for cyf-piscine pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 93e1012

@netlify
Copy link

netlify bot commented Jan 29, 2026

👷 Deploy request for cyf-common pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 93e1012

@netlify
Copy link

netlify bot commented Jan 29, 2026

👷 Deploy request for cyf-sdc pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 93e1012

@netlify
Copy link

netlify bot commented Jan 29, 2026

👷 Deploy request for cyf-itd pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 93e1012

@netlify
Copy link

netlify bot commented Jan 29, 2026

👷 Deploy request for cyf-tracks pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 93e1012

@netlify
Copy link

netlify bot commented Jan 29, 2026

👷 Deploy request for cyf-launch pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 93e1012

Copy link
Member

@illicitonion illicitonion left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM - a few small suggestions, thanks!


## Add NODE_ENV to Your Project

**Required for:** All JavaScript/Node.js projects (frontend and backend)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
**Required for:** All JavaScript/Node.js projects (frontend and backend)
**Required for:** All Node.js projects (anything that has a `package.json` file)

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

update and change the code as you suggested

3. Fill in the form:
- **Name:** `NODE_ENV`
- **Value:** `{{team.NODE_ENV}}`
- Check **"Available at Runtime"** ✅
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Check **"Available at Runtime"**
- Make sure **"Available at Build time" is not checked**
- Make sure **"Available at Runtime"** is checked ✅


## Add NODE_ENV to Your Project

**Required for:** All JavaScript/Node.js projects (frontend and backend)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
**Required for:** All JavaScript/Node.js projects (frontend and backend)
**Required for:** All Node.js projects (anything that has a `package.json` file)

3. Fill in the form:
- **Name:** `NODE_ENV`
- **Value:** `{{team.NODE_ENV}}`
- Check **"Available at Runtime"** ✅
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Check **"Available at Runtime"**
- Make sure **"Available at Build time" is not checked**
- Make sure **"Available at Runtime"** is checked ✅

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: 📋 Backlog

Development

Successfully merging this pull request may close these issues.

2 participants