Self-Hosting Starter Guide
If you experience issues or need help, you can always head over to our Discord and ask for help!
Parts of this documentation is still referring to the old naming. Whenever something is using the Sinus
prefix, that
will change to Laci
in the future!
This article serves as a guide through the self-hosting process. You can use this as an index page, and go back to each step if you need to re-read parts or have issues.
1 - The Basics
You should familiarize yourself with the basics of running a server first first. If you are already familiar with hosting services, you can obviously skip this!
2 - Bot Setup
While technically optional, you should set up the Discord bot so you can easily interact with the Laci service, as well as create your own account.
Please head over to this article and set up your bot.)
You can run your bot on a private server if you are still testing, and later move it!
3 - Server Setup
Right now, our hosting solutions are Work in Progress. We have a Cloudflare setup that works, but requires some more effort. If you need other types of deployments, please reach out on Discord and we will try to get you started, under the premise that you are aware some changes will happen!
If you want to use the Cloudflare setup, please refer to the readme here: https://github.com/LaciSynchroni/server/blob/main/Docker/Readme.md
Future hosting solutions will be provided in https://github.com/LaciSynchroni/hosting
4 - Registration
For testing purposes, we highly recommend sticking to secret keys! You can enable oAuth2 for your users after.
4a - Using Self-Service
If you enabled service-service by setting DiscordChannelForMessages
, you should now see the self-service message of your bot in that
channel. Pin this message. Normally, the bot does this itself, but we added the bot without any permissions.
You can register your account through that self-service.
4b - Using Admin Account
If you don't want to use the self-service, you can head to our guide to enable admin access to register yourself an admin account.
Once done, you can use the /useradd
command in Discord to create new secret keys!
5 - Server Tester
Once you have a secret key, you can run our server testing tool to verify that your installation is functional. It will test core functionality. Once it runs successfully, you can try to find a friend for actual testing!