Installation -
One-Click Free Hosting

Deploy Nexus Donate quickly using free hosting platforms

Overview

Nexus Donate can be deployed using various free hosting platforms with one-click deployment. This is the fastest way to get your donation store up and running without managing your own server.

Supported Platforms

Heroku

Deploy to Heroku with a single click:

Code
[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/nexusdonate/nexus-donate)
  1. Click the deploy button above
  2. Sign up for a free Heroku account if you don't have one
  3. Configure your environment variables
  4. Deploy your application

Railway

Deploy to Railway:

Code
[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template/nexus-donate)
  1. Click the Railway deploy button
  2. Connect your GitHub account
  3. Configure your database and environment variables
  4. Deploy your application

Vercel

Deploy to Vercel:

Code
[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/nexusdonate/nexus-donate)
  1. Click the Vercel deploy button
  2. Import the repository
  3. Configure your environment variables
  4. Deploy your application

Required Environment Variables

When deploying, you'll need to configure these environment variables:

Code
DB_HOST=your_database_host

DB_NAME=your_database_name

DB_USER=your_database_user

DB_PASS=your_database_password

ADMIN_EMAIL=your_admin_email

ADMIN_PASSWORD=your_admin_password

SITE_URL=https://your-app.herokuapp.com

Database Setup

For free hosting platforms, you'll need to set up a database:

  • Heroku: Add the Heroku Postgres addon
  • Railway: Add a PostgreSQL service
  • Vercel: Use a database service like PlanetScale or Supabase

Post-Deployment

  1. Access your deployed application URL
  2. Complete the initial setup wizard
  3. Configure your payment methods
  4. Add your game servers
  5. Create your first donation packages
Note: Free hosting platforms may have limitations on database connections, file storage, and processing time. For production use, consider upgrading to a paid plan.