Getting Started with ModVC

Welcome to ModVC, the free cloud hosting platform for Node.js applications! This comprehensive guide will walk you through everything you need to know to deploy your first project.

What is ModVC?

ModVC is a free cloud hosting platform specifically designed for:

• Discord bots (Discord.js, Eris, etc.)
• Minecraft bots (Mineflayer, PrismarineJS)
• Any Node.js application

Our platform provides instant deployment, automatic SSL certificates, and 24/7 uptime for your projects.

Why Choose ModVC?

Free Forever

Unlike other platforms that charge monthly fees, ModVC offers a completely free tier with:

• 512MB RAM
• 2GB Storage
• Custom subdomain (yourapp.modvc.org)

No Credit Card Required

Sign up with just your Google account - no payment information needed.

Instant Deployment

Upload your code and have it running in seconds, not hours.

Step 1: Create Your Account

Getting started is easy:

1. Visit modvc.org
2. Click "Sign In" in the top navigation
3. Choose "Sign in with Google"
4. Authorize the application

That's it! Your account is now ready.

Step 2: Prepare Your Project

Project Structure

Your project should have the following structure:

my-project/
├── index.js        # Main entry point
├── package.json    # Dependencies
└── .env           # Environment variables (optional)

Example package.json

{
  "name": "my-bot",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "discord.js": "^14.0.0"
  }
}

Important Requirements

• Your main file should be named index.js
• Include a valid package.json with all dependencies
• Node.js version 20.x is used by default

Step 3: Upload Your Code

Method 1: Zip Upload

1. Compress your project folder into a .zip file
2. Go to your Dashboard
3. Click "Upload Code"
4. Select your zip file
5. Wait for the upload to complete

Method 2: Direct File Upload

1. Click "Choose Files"
2. Select all your project files
3. The system will organize them automatically

Step 4: Configure Your Application

Set Your Start Command

The default start command is:

node index.js

You can customize this in your dashboard settings if needed.

Environment Variables

Store sensitive data like API keys and tokens:

1. Go to Dashboard → Settings
2. Click "Environment Variables"
3. Add your variables (e.g., DISCORD_TOKEN=your_token_here)
4. Save changes

Step 5: Deploy!

1. Click the "Start" button on your dashboard
2. Watch the console for logs
3. Once running, you'll receive your public URL

Your application is now live at:

https://yourname.modvc.org

Monitoring Your Application

View Logs

Real-time console output is available in your dashboard. You can see:

• Application startup messages
• Error logs
• HTTP request logs

Check Status

The status indicator shows:

• 🟢 Running - Your app is online
• 🟡 Starting - Deployment in progress
• 🔴 Stopped - App is not running

Pro Tips

Keep Your Bot Online 24/7

Free tier applications run continuously. No need for external ping services!

Use Environment Variables

Never hardcode tokens or secrets in your code. Always use environment variables.

Monitor Resource Usage

Check your RAM and storage usage regularly in the dashboard.

Getting Help

If you run into issues:

1. Check the console logs for error messages
2. Visit our Community Forum
3. Join our Discord server for live support
4. Check the FAQ for common solutions

Happy coding! 🚀