Nginx : The Doc Is Ready

Web Development & Frameworks/nginx/dotnet.md

@@ -0,0 +1,113 @@
+# Deploying .NET on Linux
+
+This tutorial has been tested only on .NET 7 and Ubuntu 22.04.
+
+## Getting the Output
+
+First, let's install .NET:
+```bash
+sudo apt install dotnet-sdk-7.0
+```
+*Note: You can create a .NET project using `dotnet new mvc` command.*
+
+Then, we need to publish our project:
+```bash
+dotnet publish
+```
+The location of the output file will be displayed after the command finishes. Typically, the project output will be placed in:
+**bin/Debug/net7.0/publish**
+
+## Installing Nginx
+
+**Nginx** is a high-performance web server with low resource usage, distributed under the terms of the BSD license. It runs on Unix-like operating systems and is widely used, currently powering 12.07% of the internet's domains.
+
+To install **Nginx** via `apt`, use the following command:
+```bash
+sudo apt install nginx
+```
+
+Then, disable the firewall with:
+```bash
+sudo ufw disable
+```
+If you encounter an error with this command, it means you don't have a firewall. In that case, skip this part.
+
+If the installation is successful, you should see "Welcome to Nginx" when typing `localhost` in your browser.
+
+## Configuring Nginx
+
+Create a directory for your site:
+```bash
+sudo mkdir /var/www/app1 
+```
+
+Copy the contents of the `publish` directory to the newly created directory:
+```bash
+sudo cp yourprojectFolder/bin/Debug/net7.0/publish /var/www/app1
+```
+
+Then, navigate to the Nginx configuration:
+```bash
+sudo vim /etc/nginx/sites-available/default
+```
+
+Replace the contents of the file with the following:
+```nginx
+server {
+    listen        80;
+    server_name   example.com *.example.com;
+    location / {
+        proxy_pass         http://localhost:5000;
+        proxy_http_version 1.1;
+        proxy_set_header   Upgrade $http_upgrade;
+        proxy_set_header   Connection keep-alive;
+        proxy_set_header   Host $host;
+        proxy_cache_bypass $http_upgrade;
+        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header   X-Forwarded-Proto $scheme;
+    }
+}
+```
+*Note: Replace `example.com` with your site address.*
+
+Check the configuration file syntax:
+```bash
+sudo nginx -t
+```
+
+If no errors are reported, reload Nginx to apply the changes:
+```bash
+sudo nginx -s reload
+```
+
+## Adding the Site as a Service
+
+Create a service file for your site:
+```bash
+sudo vim /etc/systemd/system/app1.service
+```
+
+Copy the following code into the file:
+```plaintext
+[Unit] 
+Description=dotnet webapp
+[Service] 
+WorkingDirectory=/var/www/app1
+ExecStart=/usr/bin/dotnet /var/www/app/projectname.dll 
+Restart=always
+RestartSec=10
+SyslogIdentifier=projectname
+Environment=ASPNETCORE_ENVIRONMENT=Production
+    
+[Install]
+WantedBy=multi-user.target
+```
+*Note: Replace `projectname` with your project's name.*
+
+Enable and start the site, and check its status:
+```bash
+sudo systemctl enable app1.service
+sudo systemctl start app1.service
+sudo systemctl status app1.service
+```
+