How to Install Ravix on a VPS in 10 Minutes: A Step-by-Step Guide

A complete guide to installing Ravix CMS on an Ubuntu server with one command: PostgreSQL, Nginx, free HTTPS and daily backups, all automatic. From a fresh server to your admin pa…

  • 3 min read

Want your website on your own server, with HTTPS, automatic backups and no configuration headaches? The Ravix installer does all of it with a single command. In this guide we start from a fresh Ubuntu server and reach the site's admin panel in about 10 minutes.

Requirements

  • A fresh VPS running Ubuntu 22.04, 24.04 or 26.04
  • root access over SSH
  • A domain whose A record (and www, if you want it) already points to the server's IP
  • Ports 80 and 443 open

Tip: make sure your domain's DNS has reached the server before you start. The HTTPS certificate can't be issued without it.

Step 1: Connect to the server

Connect from a terminal (or an app like Termius or PuTTY):

ssh root@YOUR-SERVER-IP

Step 2: Get the Ravix code

apt update && apt install -y git
git clone https://github.com/ravixcms/ravixcms.git
cd ravixcms

Step 3: Run the installer

Replace example.com with your domain and the email with your own (the email is only used for the Let's Encrypt certificate):

sudo ./install.sh --domain example.com --email you@example.com --yes
  • Without --yes, the installer asks before every change.
  • To see what the installer would do without changing anything on the server:
sudo ./install.sh --dry-run --domain example.com

What exactly does the installer do?

  1. Installs only the missing packages it needs: Python, PostgreSQL, Nginx and certbot.
  2. Creates a separate system user called ravix (with no login) and the app folders under /srv/ravix.
  3. Creates the PostgreSQL database with a random password.
  4. Writes the settings file /etc/ravix/ravix.env with secure keys.
  5. Sets up systemd services: the site itself, scheduled post publishing and daily backups.
  6. Configures Nginx with gzip compression, static file caching and HTTP/2.
  7. Gets a free HTTPS certificate from Let's Encrypt and redirects HTTP to HTTPS.
  8. Finally checks the site's health and prints the install page address and an install token.

Running the installer again is safe: each step checks the current state first and is skipped if it's already done. The full install log is saved to /var/log/ravix-install.log.

Step 4: Finish the setup in your browser

Open https://your-domain/install/ and fill in the form:

  • Install token: the one the installer printed. It stops a stranger from becoming the site admin before you do.
  • Site name
  • Language and time zone
  • Super admin username, email and password

Click "Install". You're logged straight into the admin panel, and the install page is closed for good from that moment.

Step 5: Clear the token

After a successful install, run the installer once more so it removes the token from the settings file:

sudo ./install.sh

After installation

  • Sample content: one post and two sample pages ("About" and "Contact") are created. Edit them, or remove them from the dashboard with "Delete sample content".
  • The getting started guide on the dashboard shows your next steps: logo, first post and choosing a theme.
  • Site Health (Panel → System) shows the state of the server and backups. A few warnings are normal on a fresh server, such as SMTP email not being configured yet.
  • To design your pages, head to the Ravix Studio page builder.

If something goes wrong

  • The HTTPS certificate wasn't issued: usually the domain's DNS doesn't point to the server yet. Wait a bit and run the installer again.
  • "Invalid install token": copy the token from the end of the installer output or from the log file.
  • You can't log in after installing: login only works over HTTPS, so open the address with https.

Other ways to install

  • Docker: docker compose up -d --build for a quick test, or on servers that already run Docker.
  • cPanel shared hosting (experimental): just like WordPress, upload the files and finish the setup in your browser.

Get started now: find the latest version and more details on the Ravix download page and the source code on GitHub.

Related articles

Comments

No comment has been posted yet.

Write your comment