Tip
This guide is for developers who want to set up their own Disend clone. You can install the official Disend app using the install link.
Disend is powered by Cloudflare Workers which requires you to create a Cloudflare account. You only need a Workers Free plan and don't need to pay anything.
It is recommended you make your first Discord app before you start setting up Disend, so you are familiar with the Discord Developer Portal and how to create an app. Additionally, you can follow the deploying Discord apps on Cloudflare Workers tutorial to get a better understanding of how hosting Discord apps on Cloudflare Workers works in general.
This guide will walk you through the steps to create, configure, and deploy your own Disend clone to Cloudflare Workers.
Note
Make sure you have Node.js installed. You can check if you have Node.js by running node -v.
Clone the project:
git clone https://github.com/ryanlua/disend.gitNavigate to the cloned directory and install dependencies:
cd disend
npm installYou will need to create a Discord app in the Discord Developer Portal if you haven't already.
After you create your app, you'll land on the General Information page of the app's settings where you can update basic information about your app like its description and icon.
In your code editor, duplicate .example.dev.vars and rename it to .dev.vars in the root of the project directory.
On your Discord app's settings, enter your app credentials in .dev.vars:
-
On the General Information page, copy the value for Application ID. In
.dev.vars, enter your pasted value inDISCORD_APPLICATION_ID
-
Back on the General Information page, copy the value for Public Key. In
.dev.vars, enter your pasted value inDISCORD_PUBLIC_KEY
-
On the Bot page under Token, click "Reset Token" to generate a new bot token. In
.dev.vars, enter your pasted value inDISCORD_TOKEN
Warning
Make sure to never share your token or check it into any kind of version control or someone could take control of your bot.
When you're done, your .dev.vars file should look similar to this:
DISCORD_APPLICATION_ID="1239324702514745386"
DISCORD_PUBLIC_KEY="e1691824041f17697c12ff66429b4fd4ccfd7d6b4c1e9609e5c11792c9e3dbf8"
DISCORD_TOKEN="MTIyODE2ODU0OTU4ODAxMzA3nF.GNpmqK.5Wkne-2gXrjWEMOCLVHq41X3xLiuV5fbvRtoow"You will need to configure your Discord app to allow it to be installed on servers along with setting up an install link for users to install your app. Your app can either be public or private. If your app is public, then anyone can find it and install it. If your app is private, then only you can install it using the install link.
Private Bot
On the Bot page, then under Authorization Flow, make sure "Public Bot" is not selected.
On the Installation page, then under Installation Contexts make sure "Guild Install" is selected.
On the Installation page, go to the Install Link section and select "None".
On the OAuth2 page, then under OAuth2 URL Generator, add the applications.commands and bot scope and under Bot Permissions, add the Send Messages and View Channels permission.
Copy the Generated URL and paste it in your browser to add your bot to your server. It should look like this:
https://discord.com/oauth2/authorize?client_id=1239324702514745386&permissions=3072&integration_type=0&scope=bot
Public Bot
On the Bot page, then under Authorization Flow, make sure "Public Bot" is selected.
On the Installation page, then under Installation Contexts make sure "Guild Install" is selected.
On the Installation page, go to the Install Link section and select "Discord Provided Link" if it's not already selected.
When Discord Provided Link is selected, a new Default Install Settings section will appear, which we'll configure next.
On the Installation page in the Default Install Settings section:
- For Guild Install, add the
applications.commandsandbotscope and theSend MessagesandView Channelspermission.
On the Installation page, go to the Install Link section and copy the Discord provided install link and paste it in your browser to add your bot to your server. It should look like this:
https://discord.com/oauth2/authorize?client_id=1239324702514745386
In your terminal within the project folder, run the following command:
npm run registerThe commands will be available in your Discord app after a few minutes. You can test them by typing / in any server where your app is installed. They won't work until you deploy your app to Cloudflare Workers, which we'll do next.
To deploy your app to Cloudflare Workers:
npm run deployIf you're not logged in to Cloudflare Workers, you'll be prompted to log in. Follow the instructions to log in to your Cloudflare account. Here you can sign up for a free account if you don't have one.
When you finish deploying, you should see a message similar to this:
npm run deploy
> deploy
> wrangler deploy
⛅️ wrangler 4.71.0
───────────────────
Total Upload: 235.65 KiB / gzip: 39.13 KiB
Worker Startup Time: 16 ms
Uploaded disend (5.00 sec)
Deployed disend triggers (2.42 sec)
https://disend.ryanluu.workers.dev
Current Version ID: 06be9f02-78b3-4d43-a5ad-aba060222624Copy your workers.dev URL from the output, which in this case is https://disend.ryanluu.workers.dev. Your URL will be different.
Go to your app's settings and on the General Information page under Interaction Endpoint URL, paste your workers.dev URL and append /interactions.
Click Save Changes and ensure your endpoint is successfully verified.
You now have your own Disend clone set up and deployed! You can test it by typing / to send your first message from the app.