VPS & Cloud Configuration

Learn how to deploy and configure your RoqueOS Server on a VPS (Virtual Private Server) to get 24/7 global access to your own cloud platform.

---

What is a VPS?

A Virtual Private Server is a virtual machine you rent monthly from a cloud provider. It's the ideal way to keep your RoqueOS Server online at all times, with high-speed internet, without consuming your local computer's power, and with reliable public IP addresses.

---

Recommended Providers

Provider	Highlight	Cost
Oracle Cloud	"Always Free" Tier with ARM instances	Free (hard to get approved)
Hetzner	Super cheap and powerful ARM instances	€4–10/month
DigitalOcean	Easy for beginners, great documentation	$6–12/month
Contabo	Unbeatable prices for massive RAM and CPU	$5–15/month

---

Recommended Minimum Requirements

For a smooth experience with RoqueOS and the ability to install Docker apps:

Resource	Minimum	Recommended
RAM	2 GB	4 GB or more
CPU	2 vCPUs	4 vCPUs
Disk	20 GB SSD	40 GB+ NVMe
OS	Ubuntu 22.04 LTS	Ubuntu 24.04 LTS
Architecture	amd64 or arm64	arm64 (better value)

---

Step by Step: From Zero to Server

1. Rent and access the VPS

After renting your VPS and receiving the credentials, access it via SSH:

ssh root@YOUR_VPS_IP

2. Update the system and install Docker

apt update && apt upgrade -y
curl -fsSL https://get.docker.com | sh

3. Install RoqueOS Server

curl -fsSL https://roqueos.com.br/install.sh | bash

Or use the manual installation with docker compose as described on the installation page.

---

Configuring the Firewall

UFW (Linux)

sudo ufw allow 22/tcp    # SSH
sudo ufw allow 27021/tcp # RoqueOS Server
sudo ufw enable

Provider Firewall

On providers like Oracle Cloud, AWS, GCP, and Azure, you also need to open the port in their web panel:

1. Go to your instance's network settings.
2. Add an Ingress Rule.
3. Allow TCP traffic on port 27021 (source: 0.0.0.0/0).

---

How to Access

Once the server is running and the firewall is open, you have two ways to connect:

Option 1: Direct Connection

Access using the public IP of the VPS:

http://YOUR_VPS_IP:27021

MIXED CONTENT WARNING

If you use RoqueOS via the official HTTPS web version (https://roqueos.com.br), the browser will block pure HTTP connections. Use a Cloudflare tunnel or configure HTTPS to bypass this.

Option 2: Cloudflare Tunnels (Recommended)

For greater security and convenience. The tunnel gives your server a secure domain (https://...) without exposing any ports in the firewall. RoqueOS Server itself has built-in integration with Cloudflare Tunnels directly from the Administration Panel.

Result: https://your-tunnel.trycloudflare.com

To configure, go to Admin Panel → Cloudflare and follow the instructions in the interface.

---

Performance and Stability Tips

Create a Swap File

If your VPS has low RAM (1–2 GB), Swap is essential to avoid crashes:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Configure Auto Restart

Ensure your docker-compose.yml includes restart: unless-stopped in all services. The automatic installation script configures this by default.

Regular Backups

Regularly back up the ./data folder where the docker-compose.yml is located. It contains:

• The SQLite database with API Keys and configurations
• Container metadata and admin preferences

tar -czf roqueos-backup-$(date +%Y%m%d).tar.gz ./data