This is my ultra-quick, rundown of how I self hosted revolt. It may not be 100% accurate, I might mess something up, and it might not work, but it might help out.
I've also got some personal server-setup preferences in here, so you'll get a couple bonuses, like a Portainer web UI for managing your Docker stacks, and a backup system. Feel free to ignore those/leave them out.
There are lots of different places to get servers, so I'm going to gloss over this step, other than an important piece:
Lots of cloud providers automatically block lots of ports though a firewall that can be configured in the UI. Usually port 22 ( SSH ) is already allowed. You need to make sure that port 80 and port 443 are also allowed.
You need to register a domain with some domain provider, which is out of scope for this tutorial, except for the next important step:
You need to create a new DNS record that points *.yourwebsite.com to your server's IP address. Exact process is out of scope.
See the Docker Documentation.
The "core stack" is what I call the first docker stack we deploy. We will put our Traefik load balancer in this core stack. We keep it separate from our Revolt stack because Traefik can be useful when we have any number of different apps hosted on our server, and it won't really need to change much.
First off, make sure you're logged in as root on your server and create some folders:
# Create folder for storing docker volumes
mkdir -p /docker-volumes/
chmod 700 /docker-volumes
# Create folder for storing our backups
mkdir -p /backups/
chmod 700 /backups
# Create the folder for the docker core stack
mkdir -p /docker-compose-core-stack/
chmod 744 /docker-compose-core-stackNow we need to create the Docker network we will use for our reverse proxy.
docker network create webgatewayCreate copy this file to /docker-compose-core-stack/docker-compose.yml.
And copy and modify this file to /docker-compose-core-stack/.env.
Modify the RESTIC_PASSWORD and DOMAIN variables in that .env file to match your domain and desired password.
Also run this command and fill out the password:
$ htpasswd -n myusername
myusername:$apr1$tB7jbznW$IH0wShSpEJ6xUJnKL4JjQ.And copy that and put it in between the quotes after TRAEFIK_USERS. That is the password to your traefik dashboard ( which you might not need, but can be useful when routing goes bad.
Finally, make sure you're in /docker-compose-core-stack and run docker-compose up -d to start all the services.
You should now be able to go to portainer.your-website.com, and walk through the process to create your user account for managing Docker through the portainer web interface.
In the portainer web UI, you can now go to stacks and click "Create Stack".
Paste this file in as the Docker Compose YAML.
Then add the following environment variables using the slot below the code block:
DOMAIN=chat.your-website.com
MINIO_ROOT_PASSWORD=securepassword
MINIO_ROOT_USER=admin
VAPID_PRIVATE_KEY=[insert your vapid private key]
VAPID_PUBLIC_KEY=[insert your vapid public key]
Now click the "Deploy" button at the bottom.
If that works great! Otherwise, you'll have to figure out what went wrong.
That's all the time I have for writing a guide, right now, but hopefully it helps.
A great bonus is that now you have a great server setup for hosting any other Docker apps that you want too. Just create another stack in the web UI and you can deploy all kinds of apps like a pro!
THE ADVICE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE ADVICE OR THE USE OR OTHER DEALINGS IN THE ADVICE.