Merged local changes

This commit is contained in:
Maciej Krzyżanowski 2023-03-18 10:31:07 +01:00
commit 7fb77856d6

View File

@ -6,17 +6,26 @@
To start this application you need to: To start this application you need to:
1. Configure database 1. You can use `git clone https://github.com/Skrytka-App/Skrytka.App` to download this app.
2. Configure database
- Install PostgreSQL DBMS - Install PostgreSQL DBMS
- Setup some database and user with permissions to it - Setup some database and user with permissions to it
- Create .env file in the main directory and fill it in with fields DB_USER, DB_PASS, DB_HOST, DB_PORT, DB_NAME and COOKIE_SECRET. In case of confusion you may check exemplary .env file saved as .env.example in the root directory of this repository. - Create .env file in the main directory and fill it in with fields DB_USER, DB_PASS, DB_HOST, DB_PORT, DB_NAME and COOKIE_SECRET. In case of confusion you may check exemplary .env file saved as .env.example in the root directory of this repository.
2. Run both SQL scripts, which are located in the main directory. For app to be usable it is also recommended to insert some data to the database. 3. Run SQL migrations. To do that you should have knex installed globally (npm install knex -g) and then execute `knex migrate:latest` in the root directory. For app to be usable it is also recommended to insert some data to the database.
- Note: Images should be added in media/images directory and image paths inserted into database should only contain part starting with images/ for example image may be uploaded at media/images/wozLEFT.webp and path in database should be images/wozLEFT.webp. - Note: Images should be added in media/images directory and image paths inserted into database should only contain part starting with images/ for example image may be uploaded at media/images/wozLEFT.webp and path in database should be images/wozLEFT.webp.
3. Run `npm install` in the main directory. 4. Run `npm install` in the main directory.
4. Run `npm install` in the client directory. 5. Run `npm install` in the client directory.
5. Run `npm build` in the client directory. 6. Run `npm build` in the client directory.
- You need to do this after every update of app's frontend (you can do it every time you pull new version of this app). - You need to do this after every update of app's frontend (you can do it every time you pull new version of this app).
6. Run `npm start` in the main directory 7. Run `npm start` in the main directory
7. App will run on localhost:5000 8. App will run on localhost:5000
Note: pm2 or/and nginx may be used to run this app for production Note: pm2 or/and nginx may be used to run this app for production
## Updating
1. Stop the app. Execute `pm2 stop <your-app-name>` if you use pm2.
2. Use `git pull` to get latest changes.
3. Run `knex migrate:latest` in the root directory. Remember you need to have knex installed globally to do that.
4. Go to client directory and enter `npm build`.
5. Start the app. If you use pm2, exectue `pm2 start <your-app-name>`.