-
Notifications
You must be signed in to change notification settings - Fork 8
How to self host
We have a lot of options on running your own version of Clara for your own server.
Note: Options marked with "^" means they are in beta and haven't been tested thoroughly. But they do work. Trust me.
This is the most laziest way and the easiest way to deploy Clara. Just click on the button above to get your copy of Clara without breaking a sweat. This one deploys from the 0.4.x
branch and has been tested properly. This deployment option is already setup and has the required dependencies for running this bot.
You should encounter a screen like this (if you signed up for Heroku already)
You should see some fields which you need to fill, though most of them aren't that mandatory.
Note: You do not need to fill in those aren't marked as Required. The bot can simply work without them.
-
- This is your User ID, which you can get via enabling Developer Mode, right clicking onto yourself, and clicking "Copy ID". This is required for you as this would let you gain access to admin-only commands.
-
- This is your application's token. You can get this by making a new Discord Application and creating a bot user.
-
- This is your Bot's Prefix. Avoid adding quotes of some sort.
-
- How many instances of the bot do you want to run. Defaults to 1 if undefined.
-
- Only enable this if you wanna find out what kind of cryptic Promise logs you want to get. Useful for bug testers and developers.
-
- This is required for Music as it would allow you to interact with the Youtube API. Grab your key from the Google Developers' Console.
-
- Required if you wanna use the Saucenao service for finding sources of Anime illustrations. Simply go to their page and go to account, make an account, and grab your key from the api section.
-
- The game name you want your bot to display.
-
- The game URL for your bot's playing status (if you wanna promote your channel or just want to plain mess around with the cool Streaming status)
-
- Required for ibsearch command.
-
- Required for checking osu!related stuff. The bot will automatically unload any osu!related commands if this is not found.
-
- If you want to find out what goes inside. useful if you're gonna help us debug Clara.
-
- the database URL for connecting to the bot. Heroku has this covered for you. But for OpenShift deployments, you have to parse your Redis Database URLs.
-
- This is for getting some cool Astronomy pic of the day from NASA. Get an API key here
Note: Music does not work in OpenShift Online since the service is not designed to maintain UDP connections.
If you have a OpenShift.com account and want to try Clara. We provide a Docker image for you.
Note: DO NOT USE the S2I Images and just follow the instructions here! Current S2I Images does not support the current Clara version.
-
First deploy a Persistent or an Ephemeral image of Redis on your project. Setup a password if necessary.
-
Then go to the Project where you have deployed your Redis instance.
-
Go to Resources > Config Maps and make a config map using the config layout from this Tutorial.
-
Go back to overview, Click on Deploy and image, and check image name.
- We provide two Clara Images, respectively:
-
claritymoe/clara:latest
for the stable Clara. -
claritymoe/clara:nightly
for the Nightly Clara.
-
- We provide two Clara Images, respectively:
-
Deploy, and apply your config map via going back to Resources > Config Maps and selecting your config maps and clicking "add to application".
-
First Create a Pod using
redis:latest
. -
Go to Create Resource, and pull a Clara image.
- We provide two Clara Images, respectively:
-
claritymoe/clara:latest
for the stable Clara. -
claritymoe/clara:nightly
for the Nightly Clara.
-
- We provide two Clara Images, respectively:
-
Apply Environment variables. Use the Config Parameters specified above.
-
Then click on Deploy.
However, if you don't feel like doing this manually, we provide Manifests that automatically makes the pods specified.
If you don't want either of this two, you can run your own Clara locally.
For windows :
For Linux distributions :
You can find most of these in your distribution.
- First, Clone this repository:
$ git clone https://github.com/ClarityMoe/Clara.git
- Then, Go to your repository in the command line
$ cd Clara
- Finally, run NPM Install.
$ npm i --save
-
PM2
- First, install pm2 globally via npm
$ npm i -g pm2
- Then copy
config.json.example
asconfig.json
. the following parameter names are almost identical as used in the Config parameters. - Start the bot
$ cd Clara/src $ pm2 start ./pm2.json
Reminder Clara can also run without PM2, so if you're using another monitoring service, it won't cause any conflicts to Clara.
Here are the options in running Clara! if you need any more assistance, You can contact at [email protected] or go to our Discord Server
Support us by donating to Capuccino's Patreon