Self hosting

Important

You don't need to self-host Fable to use it!
You can invite our official verified bot to your server for free.

Note

Our team does not provide support about self-hosting and won't help you setup self-hosted instances, asking for help in the discord server is only allowed if you find an issue or something missing from this wiki, please read carefully.
While we still use Deno Deploy and MongoDB, this guide is sightly outdated, and will be updated soon, in the meanwhile our discord is open to answer any questions.

Important

Your version of Fable will be empty and won't have any packs or access to our official/community packs registry (for cost related reasons).

MongoDB

1. Follow any guide online to get a Mongo database online and get the connection URI, the recommended way is through MongoDB Atlas which offers a free tier.
2. If not using Atlas make sure your database has ReplicaSet enabled.
3. It also must support search indexes $search
4. Get and store your MongoDB connection URI for the next step.

Deno Deploy

1. Fork this repo
2. Go to https://dash.deno.com
3. Click New Project
4. Select your fork of Fable
5. Go down to Entrypoint and select src/deno.ts
6. Click Deploy Project
7. Wait for it to finish.
8. Click Add environmental variables and then add the following:

• APP_ID is your discord app id (required)
• PUBLIC_KEY is your discord app public key (required)
• BOT_TOKEN is your discord app bot token (required)
• MONGO_URI a MongoDB connection URI (required)

Warning

If the app commands don't appear when you type /
You might need to also add the env vars APP_ID and BOT_TOKEN to github actions secrets and then re-deploy the project from the deno dashboard.

Important

If you are planning to use community packs on your new self-host of Fable.
You will also have to fork and setup fable-community/packs

Last Step

• Go do your discord developers portal
• Put the deno deploy URL (https://deno_id.deno.dev) into the "INTERACTIONS ENDPOINT URL" box
  • replace deno_id with your actual id/url from the deno deploy dashboard.

That's it, Your instance of Fable should be working.