Documentation
Deployment
Web Hosting

Web Hosting

Apache

The Apache HTTP Server is an open-source web server software that serves web content over the internet. It’s widely used due to its reliability, flexibility, and extensibility in supporting various web technologies.

The following block in the Apache configuration file is the minimum required for hosting Recipya over the network.

<IfModule mod_ssl.c>
<VirtualHost *:443>
    ServerAdmin [email]
    ServerName [subdomain.domain.com]

    ProxyPass / http://127.0.0.1:<port>/
    ProxyPassReverse / http://127.0.0.1:<port>/

    RewriteEngine on
    RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC]
    RewriteCond %{HTTP:CONNECTION} Upgrade$ [NC]
    RewriteRule .* ws://127.0.0.1:<port>%{REQUEST_URI} [P]

    ErrorLog ${APACHE_LOG_DIR}/[log file]
    CustomLog ${APACHE_LOG_DIR}/[log file]

    SSLCertificateFile [letsencrypt file]
    SSLCertificateKeyFile [letsencrypt file]
    Include [letsencrypt ssl file]
</VirtualHost>
</IfModule>

Caddy

Caddy is a lightweight, extensible open-source web server that automatically obtains and renews TLS certificates for all your sites.

The following block in the Caddyfile is the minimum required for hosting Recipya over the network. If you are on Linux, please ensure that Recipya is running as a service.

$ sudo cat /etc/caddy/Caddyfile

domain.com {
	encode zstd gzip
	reverse_proxy localhost:PORT

	header /static/* Cache-Control "public, max-age=2678400, must-revalidate"

	log {
		output file /var/log/caddy/domain.com.access.log
	}
}

Nginx

Nginx is a powerful web server that can also be used as a reverse proxy, load balancer, mail proxy and HTTP cache. It is widely used for its high performance, efficiency in handling concurrent connections, and low resource consumption.

The following segment in the Nginx configuration file is the minimum required for hosting Recipya over the network.

server {   
    listen 80;
    server_name domain.com;

    gzip on;
    gzip_types text/plain text/css application/json application/javascript text/xml application/xml text/javascript;
     
    location / {
        proxy_pass http://127.0.0.1:<port>/;
        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/ {
        add_header Cache-Control "public, max-age=2678400, must-revalidate";
    }
    
    location /ws {
        proxy_pass http://127.0.0.1:8125;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
    }
}
Local NetworkDevelopment