f1rewall

The sleek, simple and scalable invite gateway for your Discord community

Made in

Officially supports

Optional supported technologies

F1rewall is a Discord invite gateway. It lets you easily route your Discord server invites through a controlled page with a captcha. It generates a unique, time limited one time invite for every user. Thanks to this, you can stop most bots from entering your server.

Light theme default	Dark theme default

All websites elements can be customised easily

Setup guide:

It is recommended to let your team's developer/sysadmin set this up.

This script was made for Linux/GNU, officially supported distributions are: debian, ubuntu, pop!_os, fedora and raspbian

The page is made to be easily editable by anyone with HTML/CSS/Bootstrap experience

0. Getting the code

run git clone https://github.com/MiranDaniel/f1rewall A folder called f1rewall-master with the source code has been created!

1. Creating the bot

Got to the Discord Developer Portal to create your bot. https://discord.com/developers/applications
Press "New Application" in the top right corner
Set a name, this can be anything (will be seen by server members)
Once created, click on your app in the app manager.
Head to the Bot section on left bar.
Press Add bot on the right.
Set the Public bot option to false.
Copy the token (MAKE SURE NOT TO LEAK THIS)
Paste your token in the config.yaml file, follow the instructions in it
Go back to the General information section and copy the app ID
Insert your ID here -> https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=1
Visit the link and add the bot!

Congrats! Your bot is now ready!

2. Configuring the bot

Go to your Discord (app, not dev portal) settings Advanced section.
Enable developer mode
Right click the channel you want the bot to create invites to.
Copy channel ID
Paste your ID in the config.yaml file, follow the instructions in it

Congrats! Your bot is now configured!

3. Setting up ReCaptcha

Go to https://www.google.com/recaptcha/admin/create
Set a name for your app
Select "reCAPTCHA v2"
Add your domain
Accept the terms and submit
Paste your site key in the config.yaml file, follow the instructions in it
Paste your secret key in the config.yaml file, follow the instructions in it

Congrats! Your recaptcha is now ready!

4. Running

Run apt-get update -y && apt-get upgrade -y to update your packages
Run apt-get install python3-dev -y && apt-get install python3-venv -y to install the required dependencies for Python
Run sudo make to install all dependencies
Run sh run.sh to start the server
The script will now host your gateway on the port specified in config.yaml

Debugging

If you get the make: command not found error, run sudo apt-get install build-essential to install make.

Network configuration

1. Firewall configuration

Configure your firewall and open the port specified in config.yaml

2a. DNS configuration

Remember to set a static IP and host on port 80. If you want to stop the Apache server from running on port 80, use sudo systemctl stop apache2

Follow this guide to redirect your chat.<>.<> domain to your chat gateway. https://www.namecheap.com/support/knowledgebase/article.aspx/9776/2237/how-to-create-a-subdomain-for-my-domain/

You can also use the CloudFlare Argo Tunnel.

2b. CloudFlare tunnel configuration

Read the documentation file in docs/clouflare_tunnel.md

Discord configuration

Make sure the gateway works
Disallow users on your server from making new invites, let only the bot create them
Put your logo in static/wordmark.png
Put the website background in static/background.png
Set the dark_theme value in config.yaml to set the website text color

Customisation

Read the documentation file in docs/customisation.md

Support

If you're having issues with the app please open an issue or discussion thread.

Private support can be provided. Find the contact information on https://mirandaniel.com/

Donations <3

Ethereum: 0x20D3c078958A2b866F9F423a722aF5a92bc7e08b
Polygon: 0x20D3c078958A2b866F9F423a722aF5a92bc7e08b
Binance Smart Chain: 0x20D3c078958A2b866F9F423a722aF5a92bc7e08b
Monero: 42dN1SjyQNFMu3hPjJZqXa4Z8oMMLLiPzHmC4q8h3DXWS2gHxpjACxcWyAReJGqN4RX79VTE8pEn6SVxgjCJTXhg5ECB9Qe
Banano: ban_1aws637mb3qnuf9j8swzufq3nj3fttuzkixbd817nmmhyms6a6kt1zyptq87
Nano: nano_33k5ggoycqgft9on81kd8sqkdi4c38robs4jq9xmbd6j1wgfmqbukqym38ug

License - MIT

Copyright 2021 MiranDaniel

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

zashton/f1rewall