|
17 | 17 |
|
18 | 18 | > [!NOTE] |
19 | 19 | > **Boostify** is a work-in-progress project. While our team ensures everything in our platform works flawlessly, you're more than welcome to make an issue if you find an issue. Please join our Discord server if you require any assistance: [discord.gg/vZgeWhZ9aF](https://discord.gg/vZgeWhZ9aF). |
| 20 | +
|
| 21 | +--- |
| 22 | + |
| 23 | +# Quick Start |
| 24 | + |
| 25 | +Get Boostify running in minutes using the official cloud version or self-host it yourself. |
| 26 | + |
| 27 | +## Choose Your Setup |
| 28 | + |
| 29 | +| Option | Description | |
| 30 | +| --- | --- | |
| 31 | +| βοΈ **Cloud Hosted** | Use the official Boostify bot instantly. | |
| 32 | +| π₯οΈ **Self Hosted** | Deploy your own Boostify instance using Node.js or Docker. | |
| 33 | + |
| 34 | +--- |
| 35 | + |
| 36 | +# βοΈ Cloud Hosted |
| 37 | + |
| 38 | +The fastest way to start using Boostify. |
| 39 | + |
| 40 | +## 1. Invite Boostify |
| 41 | + |
| 42 | +Invite Boostify to your Discord server: |
| 43 | + |
| 44 | +π https://discord.com/oauth2/authorize?client_id=1453802179789066442 |
| 45 | + |
| 46 | +--- |
| 47 | + |
| 48 | +## 2. Required Permissions |
| 49 | + |
| 50 | +Boostify requires the following permissions: |
| 51 | + |
| 52 | +- Add Reactions |
| 53 | +- Embed Links |
| 54 | +- Manage Roles |
| 55 | +- Send Messages |
| 56 | +- View Server Subscription Insights |
| 57 | + |
| 58 | +> [!IMPORTANT] |
| 59 | +> Place the Boostify role above any reward roles you want it to manage. |
| 60 | +
|
| 61 | +--- |
| 62 | + |
| 63 | +## 3. Configure Your Server |
| 64 | + |
| 65 | +Once invited, configure features like: |
| 66 | + |
| 67 | +- Booster reward roles |
| 68 | +- Auto thank-you messages |
| 69 | +- Logging |
| 70 | +- Moderation |
| 71 | +- Booster analytics |
| 72 | +- Freemium perks |
| 73 | + |
| 74 | +Continue to the documentation for advanced configuration. |
| 75 | + |
| 76 | +--- |
| 77 | + |
| 78 | +# π₯οΈ Self Hosting |
| 79 | + |
| 80 | +Self-host Boostify for full control and customization. |
| 81 | + |
| 82 | +--- |
| 83 | + |
| 84 | +## Requirements |
| 85 | + |
| 86 | +### Required |
| 87 | + |
| 88 | +- Node.js 20+ |
| 89 | +- PostgreSQL |
| 90 | +- Git |
| 91 | +- Discord Bot Token |
| 92 | + |
| 93 | +### Optional |
| 94 | + |
| 95 | +- Docker |
| 96 | +- PM2 |
| 97 | +- Reverse Proxy (Nginx/Caddy) |
| 98 | + |
| 99 | +--- |
| 100 | + |
| 101 | +# Installation |
| 102 | + |
| 103 | +## 1. Clone the Repository |
| 104 | + |
| 105 | +```bash |
| 106 | +git clone https://github.com/teamboostify/boostify.git |
| 107 | +cd boostify |
| 108 | +```` |
| 109 | + |
| 110 | +--- |
| 111 | + |
| 112 | +## 2. Install Dependencies |
| 113 | + |
| 114 | +```bash |
| 115 | +npm install |
| 116 | +``` |
| 117 | + |
| 118 | +--- |
| 119 | + |
| 120 | +## 3. Configure Environment Variables |
| 121 | + |
| 122 | +Create a `.env` file in the project root. |
| 123 | + |
| 124 | +```env |
| 125 | +DEBUG=true |
| 126 | +
|
| 127 | +BOT_TOKEN=your_bot_token |
| 128 | +CLIENT_ID= |
| 129 | +GUILD_ID= |
| 130 | +
|
| 131 | +GREET_CHANNEL_ID= |
| 132 | +LOG_CHANNEL_ID= |
| 133 | +
|
| 134 | +DATABASE_URL=postgresql://user:password@localhost:5432/boostify |
| 135 | +``` |
| 136 | + |
| 137 | +> [!WARNING] |
| 138 | +> Never share your bot token or commit your `.env` file publicly. |
| 139 | + |
| 140 | +--- |
| 141 | + |
| 142 | +# Database Setup |
| 143 | + |
| 144 | +Generate the Prisma client: |
| 145 | + |
| 146 | +```bash |
| 147 | +npx prisma generate |
| 148 | +``` |
| 149 | + |
| 150 | +Run migrations: |
| 151 | + |
| 152 | +```bash |
| 153 | +npx prisma migrate deploy |
| 154 | +``` |
| 155 | + |
| 156 | +--- |
| 157 | + |
| 158 | +# Running Boostify |
| 159 | + |
| 160 | +## Development |
| 161 | + |
| 162 | +```bash |
| 163 | +npm run dev |
| 164 | +``` |
| 165 | + |
| 166 | +## Production |
| 167 | + |
| 168 | +```bash |
| 169 | +npm run build |
| 170 | +npm start |
| 171 | +``` |
| 172 | + |
| 173 | +--- |
| 174 | + |
| 175 | +# Docker Deployment |
| 176 | + |
| 177 | +Boostify supports Docker deployments out of the box. |
| 178 | + |
| 179 | +## Build the Image |
| 180 | + |
| 181 | +```bash |
| 182 | +docker build -t boostify . |
| 183 | +``` |
| 184 | + |
| 185 | +## Run the Container |
| 186 | + |
| 187 | +```bash |
| 188 | +docker run -d \ |
| 189 | + --name boostify \ |
| 190 | + --env-file .env \ |
| 191 | + boostify |
| 192 | +``` |
| 193 | + |
| 194 | +--- |
| 195 | + |
| 196 | +# Recommended Production Stack |
| 197 | + |
| 198 | +For the best production experience, we recommend: |
| 199 | + |
| 200 | +* Docker |
| 201 | +* PM2 |
| 202 | +* Linux VPS |
| 203 | +* Managed PostgreSQL |
| 204 | +* Reverse Proxy (Nginx or Caddy) |
| 205 | + |
| 206 | +--- |
| 207 | + |
| 208 | +# Features |
| 209 | + |
| 210 | +* π Boost Tracking |
| 211 | +* π Reward Roles |
| 212 | +* π¬ Auto Thank-You Messages |
| 213 | +* π Booster Analytics |
| 214 | +* π‘οΈ Moderation |
| 215 | +* π Logging |
| 216 | +* β‘ Freemium Perks |
| 217 | +* π³ Docker Support |
| 218 | +* π§ Self Hosting |
| 219 | +* π Cloud Hosted Version |
| 220 | + |
| 221 | +--- |
| 222 | + |
| 223 | +# Support |
| 224 | + |
| 225 | +Need help? |
| 226 | + |
| 227 | +* Join the support server: [https://discord.gg/vZgeWhZ9aF](https://discord.gg/vZgeWhZ9aF) |
| 228 | +* Open an issue on GitHub |
| 229 | +* Check the documentation |
| 230 | + |
| 231 | +--- |
| 232 | + |
| 233 | +# Project Status |
| 234 | + |
| 235 | +> [!NOTE] |
| 236 | +> Boostify is currently under active development. |
| 237 | +> |
| 238 | +> While the platform is stable for most use-cases, features may change and improve over time. If you encounter issues, please open an issue or join our support server. |
| 239 | + |
| 240 | +--- |
| 241 | + |
| 242 | +<div align="center"> |
| 243 | + Made with β€οΈ by Team Boostify |
| 244 | +</div> |
0 commit comments