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…

On this page
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?
- Installs only the missing packages it needs: Python, PostgreSQL, Nginx and certbot.
- Creates a separate system user called
ravix(with no login) and the app folders under/srv/ravix. - Creates the PostgreSQL database with a random password.
- Writes the settings file
/etc/ravix/ravix.envwith secure keys. - Sets up systemd services: the site itself, scheduled post publishing and daily backups.
- Configures Nginx with gzip compression, static file caching and HTTP/2.
- Gets a free HTTPS certificate from Let's Encrypt and redirects HTTP to HTTPS.
- 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 --buildfor 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.
Comments
No comment has been posted yet.