summary refs log tree commit diff
diff options
context:
space:
mode:
authorMadeline <46743919+MaddyUnderStars@users.noreply.github.com>2022-10-01 22:22:06 +1000
committerMadeline <46743919+MaddyUnderStars@users.noreply.github.com>2022-10-01 22:33:23 +1000
commitbb29b71c0f7175c2e68962836ecaeeb85189db56 (patch)
tree50ab2b9e54e6f8cc94493963624117760ee41ebe
parentSlightly better embeds (diff)
downloadserver-bb29b71c0f7175c2e68962836ecaeeb85189db56.tar.xz
Update readme.
-rw-r--r--README.md102
1 files changed, 88 insertions, 14 deletions
diff --git a/README.md b/README.md
index 6aac9e57..1dbdfba7 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,92 @@
 <p align="center">
-  <img width="100" src="https://raw.githubusercontent.com/fosscord/fosscord/master/assets-rebrand/svg/Fosscord-Icon-Rounded-Subtract.svg" />
+	<img width="100" src="https://slowcord.understars.dev/icons/992709344367829040/b58b15cdeee1dddcd3769f78217aca1a.webp?size=96"/>
 </p>
-<h1 align="center">Fosscord Server</h1>
+<h1 align="center">Slowcord</h1>
 
-<p align="center">
-  <a href="https://discord.gg/ZrnGQP6p3d">
-    <img src="https://img.shields.io/discord/806142446094385153?color=7489d5&logo=discord&logoColor=ffffff" />
-  </a>
-  <img src="https://img.shields.io/static/v1?label=Status&message=Development&color=blue">
-  <a title="Crowdin" target="_blank" href="https://translate.fosscord.com/"><img src="https://badges.crowdin.net/fosscord/localized.svg"></a>
-   <a href="https://opencollective.com/fosscord">
-    <img src="https://opencollective.com/fosscord/tiers/badge.svg">
-  </a>
-</p>
+### Notice: **DO NOT** ask for support regarding Slowcord in the Fosscord support server.
+
+This branch hosts the source for [Slowcord](https://slowcord.understars.dev). It is *vastly* different than standard Fosscord, with many new features, bug fixes and improvements.
+
+If you would like to host Slowcord yourself, you should know:  
+* **You will not receive support**. I am a university student, who works on this in my free time because it's fun. What is not fun is helping people with the same 5 problems.
+* **Slowcord is configured in a very specific way**. There exists parts of the codebase which assume things about your system's configuration which may not be documented here. You **will** need to edit things here to get them to work.
+* **There is no voice/video server, and no admin dashboard** yet. There do not exist on any Fosscord instance.
+
+Alright, now onto the guide.  
+## The Guide
+The guide assumes:
+* You're using Ubuntu
+* You've got a domain name, and you are NOT using ngrok, cloudflare tunnels, hamachi.
+* With said domain name, you've got DNS records pointing it to your server
+
+### Installing Slowcord
+
+```sh
+# deps make, git, gcc, g++, etc
+sudo apt install build-essential
+
+# deps for canvas npm package
+sudo apt-get install build-essential libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev
+```
+
+You also need Node, at least version 16. Just go with the latest. It's easiest if you use [node version manager](https://github.com/nvm-sh/nvm).
+
+Now to install Slowcord:
+```sh
+# TODO: once `slowcord-refactor` has been merged into `slowcord`, replace this line.
+git clone -b slowcord-refactor https://github.com/MaddyUnderStars/fosscord-server.git
+cd fosscord-server
+npm i
+npm run build
+
+# you may now use this last command to start the server
+npm run start
+```
+
+You should probably run the start command in a `screen`, or with systemd, instead.
+
+### Installing Nginx, getting an SSL cert
+```sh
+sudo apt install nginx certbot python3-certbot-nginx
+```
+
+Copy the file at `fosscord-server/src-slowcord/nginx/fosscord` to `/etc/nginx/sites-enabled/fosscord` and edit it how you see fit. That is:
+* Edit the `server_name`
+* If you're not using the Slowcord login server, remove the `location` block related to it
+* Remove the Slowcord SSL cert stuff, you'll generate your own later.
+* Also edit the `$host = whatever` line at the bottom., and the server name in that block.
+
+Now, generate an SSL cert with certbot:
+```sh
+certbot --nginx
+```
+It'll ask you a bunch of questions, generate a cert, and edit your config to match.
+You may need to run `sudo systemctl restart nginx`.
+
+At this point, you can probably start Slowcord using `npm run start` in the project root.
+
+### Configuration
+Almost all config is done through the `config` table of your database. The values are either self explainatory, or have documentation on https://docs.fosscord.com. Slowcord's config provides sane defaults for most things, but you may want to edit:
+* `cdn_endpointPublic`: The CDN url given to clients. Change this to your domain. Protocol is `https`, assuming you've got SSL.
+* `gateway_endpointPublic` See above, but for the gateway. Protocol is `wss`, with SSL.
+* `security_defaultRights` The default rights value is discord.com-like by default. Check the fosscord docs for info about rights.
+* `guild_defaultFeatures_X` The default features of a guild. Used to grant premium features to all guilds on Slowcord. You may want to do the same. [List of guild features](https://gist.github.com/Techy/ecc60b12e94f8fc8185f09b82aa91dd2). This value is an array, `X` is a number, starting a `0`.
+* `security_captcha_enabled`, and related values.
+
+The `.env` file in the project root doesn't have any defaults, but I recommend you use this:
+```
+THREADS=1
+DATABASE=YOUR DATABASE CONNECTION STRING.
+```
+
+Not providing a `DATABASE` will set Slowcord to use SQlite, which is not very performant at scale. I recommend Mariadb or Postgresql, as they are quite well-used in the Fosscord community.
+
+### Some useful scripts
+* `npm run generate:client`. Downloads the full Discord.com web client and patches it. Edit the script to change what the patches do, such as changing `Discord` -> `Slowcord` and removing Nitro references.
+* `npm run generate:rights`. Shows all-rights values and Discord.com-like rights values.
+* `npm run generate:schema`. Generates a new `assets/schemas.json` file. If you edit any schemas, you will need to rerun this.
+
+### Slowcord additional services
+If you want to run the login server for Discord oauth, use the bot, or use the status reporting service? Just look around in the repo. It's 10:30pm, I'm too tired. Theres example .env files, and you can always look at the codebase to see what they do. They're pretty self explanatory though.
 
-Branch that [slowcord.understars.dev](https://slowcord.understars.dev) runs.  
-Generally up to date with master, also contains my fixes/etc that aren't yet merged.
+Thanks.
\ No newline at end of file