Deploying a Rust Application on VPS: A Step-by-Step Guide from A to Z

Introduction: Why Rust is Ideal for Production and How to Deploy It

Rust is a systems programming language that combines the performance of C++ with memory safety. Thanks to the absence of a garbage collector and the ability to compile into a native binary file, Rust applications are ideal for deployment on a VPS (Virtual Private Server). In this article, we will go through the full deployment cycle: from building the project to configuring a reverse proxy and monitoring. You will learn how to turn your Rust application into a stable production service.

1. Preparation: Building a Rust Application for VPS

The first step is to build an optimized binary file. For this, you will need the Rust toolchain on your local machine (or on the server).

1.1. Compilation in Release Mode

In the project root, run the command:

cargo build --release

This will create an optimized binary in the target/release/ folder. For web applications using actix-web or rocket, the file size can be 5-15 MB. To reduce the size, you can add the following to Cargo.toml:

[profile.release]opt-level = 3lto = truecodegen-units = 1strip = true

1.2. Setting Up Environment Variables

Create a .env.prod file for the production configuration. Example for a web server:

DATABASE_URL=postgres://user:pass@localhost:5432/mydbRUST_LOG=infoSERVER_HOST=0.0.0.0SERVER_PORT=8080

1.3. Transferring Files to the VPS

Copy the binary, static files, and configuration to the server. Use scp or rsync:

scp target/release/myapp user@your-vps-ip:/home/user/app/scp -r static/ user@your-vps-ip:/home/user/app/static/scp .env.prod user@your-vps-ip:/home/user/app/.env

2. Server Configuration: systemd and Nginx

To automatically start the application when the server reboots and to ensure security, we use systemd and Nginx.

2.1. Creating a systemd Service

Create the file /etc/systemd/system/myapp.service:

[Unit]Description=Rust web applicationAfter=network.target

[Service]User=www-dataWorkingDirectory=/home/user/appExecStart=/home/user/app/myappRestart=alwaysRestartSec=10EnvironmentFile=/home/user/app/.env

[Install]WantedBy=multi-user.target

Activate the service:

sudo systemctl daemon-reloadsudo systemctl enable myappsudo systemctl start myappsudo systemctl status myapp

2.2. Configuring Nginx as a Reverse Proxy

The Rust application will listen on port 8080 (internal), and Nginx will accept external requests on port 80/443. Create the configuration /etc/nginx/sites-available/myapp:

server {    listen 80;    server_name your-domain.com;

    location / {        proxy_pass http://127.0.0.1:8080;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;        proxy_set_header X-Forwarded-Proto $scheme;    }

    location /static/ {        alias /home/user/app/static/;        expires 30d;    }}

Activate the site:

sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/sudo nginx -tsudo systemctl reload nginx

2.3. Configuring HTTPS (Optional)

Install Certbot and obtain an SSL certificate:

sudo apt install certbot python3-certbot-nginxsudo certbot --nginx -d your-domain.com

3. Database Management and Migrations

If your Rust application uses a database (e.g., PostgreSQL with diesel or sqlx), configure it on the VPS.

3.1. Installing PostgreSQL

sudo apt updatesudo apt install postgresql postgres