initial commit

README.md

@@ -1,3 +1,51 @@
 # Website-template
 
-vue ts + vite frontend, express backend, with a dockerfile and a deploy script to my dokku
+vue ts + vite frontend, express backend, with a dockerfile and a deploy script to my dokku
+
+### steps to get started on the dokku side
+1. create a dokku app
+   ```bash
+   dokku apps:create <app-name>
+   ```
+2. create postgres database
+   ```bash
+   dokku postgres:create <db-name>
+   ```
+3. link the database to the app
+   ```bash 
+   dokku postgres:link <db-name> <app-name>
+    ```
+4. setup db if applicable 
+   - dump local db
+   ```bash
+    pg_dump -Fc --no-acl --no-owner -h localhost -U <db-user> <db-name> > db.dump
+    ```
+    - restore to dokku db
+   ```bash
+    dokku postgres:import <db-name> < db.dump
+    ```
+5. set app to use nginx
+    - set proxy to nginx
+   ```bash
+   dokku proxy:set <app-name> nginx
+   ```
+   
+   - map nginx port to internal docker port
+   ```bash
+    dokku ports:add <app-name> <scheme>:<nginx-port>:<internal-docker-port>
+    ```
+6. set repo dokku deploy key
+   - copy the private key from dokku into the repo secrets under the name `DOKKU_DEPLOY_KEY`
+7. add the public key to known hosts on dokku
+   ```bash
+    dokku ssh-keys:add <app-name> <path-to-public-key>
+    ```
+8. set environment variables
+   - create a `.env` file on the dokku server
+   - add the variables to the `.env` file
+   - add the variables to the app
+   ```bash
+   cat .env | xargs dokku config:set --no-restart <app-name>
+   ```
+it should be ready to go now, you can deploy with the deployment script
+