Self-Host the Creator Platform Bot

This guide will walk you through setting up your own self-hosted instance of the NotiFansly Creator Platform bot. This bot is designed specifically for creators to run for themselves, providing not just post and stream notifications, but also powerful, automatic Discord role management for your Fansly followers and subscribers.

This bot is different from the basic notification bot. It allows your fans to link their Fansly accounts to Discord, granting them roles based on their follow or subscription status, creating a seamless experience for your community.

Prerequisites

Before you begin, make sure you have the following:

A Discord account with a server you own or have administrator permissions in
A Fansly creator account with active login credentials
Basic familiarity with command line interfaces
A server or computer to host the bot (available 24/7 for best results)

Step 1: Discord Bot Setup

You’ll need to create your own Discord bot application. Since this is your personal creator bot, we’ll set it up as a private bot that only you can invite to servers.

Go to the Discord Developer Portal
Click “New Application” and give it a name (e.g., “My Community Bot”)
Navigate to the “Bot” tab
Here you can customize your bot’s username and avatar if desired
Copy your bot token by clicking “Reset Token” and then “Copy” (keep this secure!)
Under the “Authorization Flow” section:
- Uncheck “Public Bot” (this prevents others from inviting your bot to their servers)
- Leave “Requires OAuth2 Code Grant” unchecked (not needed for this bot)
Under the “Privileged Gateway Intents” section, enable:
- Presence Intent
- Server Members Intent
- Message Content Intent
Go to the “General Information” tab and copy your Application ID and Public Key (you’ll need these for your configuration)
Go to the “OAuth2” → “URL Generator” tab
Select the following scopes:
- bot
- applications.commands
Select the following bot permissions:
- Send Messages
- Embed Links
- Attach Files
- Read Message History
- Use External Emojis
- Add Reactions
- Manage Roles (Crucial for role-syncing)
- Mention Everyone
Copy the generated URL – this is what you’ll use to add your bot to your server

Example of navigating the bot setup:

Discord bot setup example guide showing how to create a private bot and generate invite link

Important: After you’ve successfully invited your bot to your server, you can further secure it by going to the “Installation” tab and setting the install link to “None”. This completely prevents anyone else from generating invite links for your bot.

Step 2: Installation

The bot is written in Go, with pre-built executables available for easy setup.

Download the latest release from the official GitHub repository

# Example for Linux (64-bit) - adjust version/platform as needed
wget https://github.com/NotiFansly/CreatorBot/releases/download/v0.1.0/notifansly_0.1.0_linux_amd64.tar.gz
tar -xzf notifansly_0.1.0_linux_amd64.tar.gz

Create a dedicated directory for your bot and move the executable into it

Step 3: Configuration

In the same directory as the bot’s executable, create a file named .env. This file will store all your bot’s configuration settings.

# --- Required Settings ---
APP_ID=YOUR_DISCORD_APP_ID
DISCORD_TOKEN=YOUR_DISCORD_BOT_TOKEN
PUBLIC_KEY=YOUR_DISCORD_PUBLIC_KEY
FANSLY_TOKEN=YOUR_FANSLY_AUTH_TOKEN
USER_AGENT=YOUR_BROWSER_USER_AGENT

# --- Optional Database Settings ---
# Defaults to a local sqlite file, which is fine for most users.
# DB_TYPE=sqlite
# SQLITE_PATH=bot.db

# For advanced users, PostgreSQL is also an option.
# DB_TYPE=postgres
# POSTGRES_URL=postgres://user:password@host:port/dbname

How to Get Your Fansly Token & User Agent

This is the fastest way to get the required credentials from your Fansly session.

Go to fansly.com, log in, and open your browser’s developer tools (usually F12 or Ctrl+Shift+I)
Click on the Console tab
Copy and paste the entire code block below into the console, then press Enter

console.clear();
const activeSession = localStorage.getItem("session_active_session");
const { token } = JSON.parse(activeSession);
console.log('%c➡️ Authorization_Token:', 'font-size: 14px; color: #8B5CF6; font-weight: bold;', token);
console.log('%c➡️ User_Agent:', 'font-size: 14px; color: #F59E0B; font-weight: bold;', navigator.userAgent);

The console will print your Authorization_Token and User_Agent. Copy these values into your .env file.

Warning: Your Authorization Token provides full access to your account. Never share it with anyone.

Step 4: Running the Bot

You can now start your bot.

# On Linux/macOS, first make the file executable
chmod +x ./discord-fansly-notify
./discord-fansly-notify

# On Windows, run the .exe file
.discord-fansly-notify.exe

For reliable 24/7 operation, it’s highly recommended to run the bot as a service using systemd (Linux) or a process manager like PM2. The setup is identical to the one described in the basic self-hosting guide.

Once the bot is running, you can invite it to your server using the URL you generated in Step 1.

Step 5: Initial Bot Setup in Discord

After inviting the bot to your server, you must configure it.

Decide which channel you want notifications to go to
Use the /add command. This single command enables the bot for your server:

/add channel:#your-notifications-channel

This command registers your creator profile with the bot for this server and sets up default notifications in the channel you specified.

Step 6: Configuring Role-Syncing

This is the most powerful feature of the Creator Bot. It automatically assigns roles to fans who link their accounts.

Note: When you first start the bot, it will perform an initial sync of your follower and subscriber data from Fansly. This can take up to 30 minutes. The /listtiers command will not show your tiers until this sync is complete.

You can trigger a manual sync at any time using the /sync command. This is especially useful after you have configured your roles and want to apply them to your linked members immediately without waiting for the next automatic cycle.

A. Set Follower & Subscriber Roles

You can assign a general role to anyone who follows you on Fansly and a base role for anyone who subscribes (at any tier).

/setfollowerrole role:@Fansly-Follower - Assigns the “Fansly-Follower” role to all linked followers
/setsubscriberrole role:@Fansly-Subscriber - Assigns the “Fansly-Subscriber” role to all linked, active subscribers

You can clear these by running the command without specifying a role.

B. Set Tier-Specific Roles

You can map your Fansly subscription tiers to specific Discord roles.

First, see which tiers the bot has synced from your profile:
```
/listtiers
```
Next, map a tier to a role using its name. The command has autocomplete to help you:
```
/settierrole tier:My Exclusive Tier role:@VIP-Subs
```
Repeat this for all the tiers you want to sync

Step 7: Instructing Your Fans to Link Accounts

For the role-syncing to work, your fans must link their Discord and Fansly accounts. The process is simple, quick and secure.

We have a dedicated, fan-facing guide that explains exactly how they can do this. You can link your community members to this page:

Fan Linking Guide →

This guide walks them through using the /link command and verifying their account by placing a temporary code in their Fansly bio. Once linked, their roles will be updated automatically during the bot’s next sync cycle (every 15 minutes).

Admin Commands Reference

Here is a list of other commands you can use to manage your bot:

Command	Description
`/add`	Enables the bot for the server and sets the primary notification channel
`/remove`	Disables and removes the bot’s configuration from the server
`/list`	Shows the current notification configuration for your profile
`/setchannel`	Sets a specific channel for posts or live notifications separately
`/setliveimage`	Sets a custom image to be used in livestream notification embeds
`/setlivemention`	Sets a role to be mentioned for livestream notifications
`/setpostmention`	Sets a role to be mentioned for new post notifications
`/toggle`	Enable or disable posts or live notifications
`/setfollowerrole`	Sets the role for your Fansly followers
`/setsubscriberrole`	Sets the base role for all active subscribers
`/listtiers`	Lists all of your Fansly subscription tiers synced by the bot
`/settierrole`	Maps a specific Fansly tier to a Discord role
`/sync`	Manually syncs followers, subscribers, and tiers from Fansly.

Frequently Asked Questions

How is this different from the other self-hosted bot?

The other bot is a simple notification forwarder that anyone can run. This Creator Bot is a full platform for you, the creator. It includes follower/subscriber data syncing and automatic role management, features the other bot does not have.

How often do roles and notifications update?

Notifications for new posts and livestreams are checked every 2 minutes
Fan roles are re-verified and synced every 15 minutes

What happens if a user’s subscription expires?

During the next sync, the bot will see that the subscription is no longer active and will automatically remove the corresponding subscriber and tier roles from the user.

Why doesn’t `/listtiers` show my tiers?

The bot needs to perform an initial data sync after it starts, which can take up to 30 minutes depending on the amount of data. Please wait a while and try the command again. Alternatively, you can run the /sync command to force an immediate data refresh.

Need Help?

If you encounter any issues or have questions, join our support server: https://discord.gg/WXr8Zd2Js7

Setup Guide (Basic)

Documentation