From c9275c10c63dfc25729f30ec6a944b39f39235b8 Mon Sep 17 00:00:00 2001
From: Pratyush Desai <pratyush.desai@liberta.casa>
Date: Sat, 16 Apr 2022 20:40:47 +0530
Subject: [PATCH] uwsginginx deploy docs

---
 DEPLOY.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 DEPLOY.md

diff --git a/DEPLOY.md b/DEPLOY.md
new file mode 100644
index 0000000..de32f2a
--- /dev/null
+++ b/DEPLOY.md
@@ -0,0 +1,36 @@
+# Deploying
+
+Deploy using nginx + uwsgi with an init system.
+
+## Resources
+
+* [flask-docs](https://flask.palletsprojects.com/en/2.1.x/deploying/uwsgi/)
+
+## Procedure
+
+### uwsgi commands and notes
+
+* `$ uwsgi -s /tmp/yourapplication.sock --manage-script-name --mount /yourapplication=myapp:app`
+* If you want to deploy your flask application inside of a virtual environment, you need to also add --virtualenv /path/to/virtual/environment. You might also need to add --plugin python or --plugin python3 depending on which python version you use for your project.
+
+### Nginx Config
+
+The Usual - This configuration binds the application to /yourapplication.
+
+```location = /yourapplication { rewrite ^ /yourapplication/; }
+location /yourapplication { try_files $uri @yourapplication; }
+location @yourapplication {
+  include uwsgi_params;
+  uwsgi_pass unix:/tmp/yourapplication.sock;
+}
+```
+
+If you want to have it in the URL root its a bit simpler:
+
+```location / { try_files $uri @yourapplication; }
+location @yourapplication {
+    include uwsgi_params;
+    uwsgi_pass unix:/tmp/yourapplication.sock;
+}
+
+```