Hosting Partner: Haven Development

Zero Development officially partners with Haven Development to provide recommended, battle-tested hosting infrastructure for Medusa.

Whether you run Medusa in a private community or across large production servers with thousands of concurrent members, Haven Development delivers the speed, low latency, and stability required for a bot with real-time web dashboards and database storage.

Why Haven Development?

Deployment Walkthrough

Follow these steps to deploy Medusa on Haven Development:

Step 1: Order a Bot Hosting Plan

1. Navigate to Haven Development.
2. Select a Discord Bot Hosting or Node.js Hosting package that fits your server size:
   • For smaller communities (under 5,000 members): A starter plan with 1 to 2 GB RAM is sufficient.
   • For larger networks or multiple active modules (music, canvas leveling, heavy moderation): Choose 2 to 4 GB RAM.
3. Complete checkout and check your email or client portal for control panel login details.

Step 2: Configure Server Settings

1. Log into your Haven Development control panel.
2. Navigate to your Medusa server instance.
3. Open the Startup tab:
   • Ensure the egg environment is set to Node.js v22 (or latest LTS).
   • Verify the Startup Command is set to:

     node index.js

4. Open the Network tab:
   • Note your server's primary IP address and main port.
   • Ensure you have additional ports assigned for:
     • Web Dashboard: maps to internal port 3000 (or your assigned external port).
     • Internal API: maps to internal port 3001 (or your assigned secondary port).

Step 3: Set Up the Database

Medusa requires PostgreSQL for relational data storage.

1. In the Haven Development panel, navigate to the Databases tab.
2. Click New Database.
3. Name your database (e.g. Medusa).
4. Once created, note the generated connection details:
   • Host (e.g. 127.0.0.1 or remote database IP)
   • Port (e.g. 5432)
   • Username
   • Password
   • Database Name

Step 4: Upload Medusa Files

You can upload your files via the panel's web file manager or via SFTP for faster bulk transfers:

Option A: Web File Manager

1. In your Haven panel, click the Files tab.
2. Compress your Medusa installation into a .zip archive (exclude node_modules to keep upload times fast).
3. Drag and drop the .zip file into the file manager.
4. Click the three dots next to the uploaded archive and choose Unarchive.

Option B: SFTP

1. Go to the Settings tab in the panel and copy your SFTP connection details.
2. Connect with FileZilla, Cyberduck, or WinSCP.
3. Upload all Medusa files directly into the root directory.

Step 5: Configure Credentials

1. In the file manager, open config.json.
2. Enter your license key, Discord application credentials, and database details from Step 3:

   {
     "LICENSING": {
       "AGREE_TO_LICENSE.MD": true,
       "LICENSE_KEY": "YOUR_MEDUSA_LICENSE"
     },
     "AUTHENTICATION": {
       "DISCORD_CLIENT_ID": "YOUR_CLIENT_ID",
       "DISCORD_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
       "SECRET": "YOUR_GENERATED_32_BYTE_HEX_SECRET"
     },
     "SETUP_USER": "YOUR_DISCORD_USER_ID",
     "DATABASE": {
       "TYPE": "POSTGRES",
       "HOST": "YOUR_DATABASE_HOST",
       "PORT": "5432",
       "USER": "YOUR_DATABASE_USER",
       "PASSWORD": "YOUR_DATABASE_PASSWORD",
       "DATABASE": "Medusa"
     },
     "SERVER": {
       "DASHBOARD": {
         "PORT": 3000,
         "URL": null,
         "DEVELOPER": false
       },
       "API": {
         "PORT": 3001,
         "URL": null,
         "LOGS": true
       }
     }
   }

3. Save the file.

Step 6: Install Dependencies and Start

1. Open the Console tab in the Haven panel.
2. If dependencies were not pre-installed, install them via the console or package manager.
3. Click the green Start button.
4. Monitor the console output. You will see Medusa boot, connect to PostgreSQL, register all 22 modules, and log in to Discord.
5. Access your dashboard using your assigned Haven server IP and dashboard port.

Partner Support

Have questions about choosing a plan, port forwarding, or optimizing your Medusa server?

• Website: havendevelopment.net
• Discord Community: Join Haven Development Discord