Vencloud

Vencloud is Vencord's API for cloud settings sync!

Self Hosting

Warning

Your instance has to be HTTPS capable due to mixed content restrictions in web browsers.

We provide a Docker build, so you don't need anything installed besides Docker!

Cloning the Repository

First of all, you'll have to clone the source code to a convenient location:

git clone https://github.com/Vencord/Vencloud

Setting up the Config

Copy the example configuration (.env.example) to .env. Now open it with your text editor of trust and fill in the configuration values. All variables are documented there!

Running

Don't forget to direct your terminal to the Vencloud directory, e.g. via cd Vencloud!

Via Docker

1. Create a docker-compose.override.yml that maps the port from docker to your system. The following example assumes you will use port 8485

   services:
     backend:
       ports:
         - 8485:8080
   

2. Start the docker container via docker compose up -d. The server will be available at the configured host, in the above example 8485

Natively

Please note that only the docker setup is supported by us. The native instructions are only provided for advanced users and we can't provide support if you get stuck! When in doubt, please use the docker setup.

Alongisde the Vencloud setup, you will also have to setup Redis. This will not be covered here, please refer to the Redis documentation.

Warning

At the current moment, Go 21 is not yet supported, you'll need Go 20! An easy way to get Go 20 is to run go install golang.org/dl/go1.20.0@latest and then use the go1.20 command instead of go

1. Install the Go programming language
2. Build the code: go build -o backend
3. Start the server:

   # Load the .env file
   export $(grep -v '^#' .env | xargs)
   
   ./backend