diff --git a/docs/docs/contribute/INSTALLATION.md b/docs/docs/contribute/INSTALLATION.md index b598b6c18..8d69b672f 100644 --- a/docs/docs/contribute/INSTALLATION.md +++ b/docs/docs/contribute/INSTALLATION.md @@ -81,63 +81,4 @@ Create an account by signing-up and start contributing. ## Localhost(Docker) - -For local Setup we need to need following prerequisite: - -Environment Varaibles: - -| Environment Varibale | Value | Description | -| ------------- | ------------- | ------------- | -| CI | false | Set CI to false while running the app locally | -| PUBLIC_URL | http://localhost:3000 | Set it to the URL form where the app home page will be accessed | -| GENERATE_SOURCEMAP | false | Set it to true if you want to generate the Sourcemap for debugging | -| REACT_APP_SERVERURL | http://localhost:8080/app | Set it to the URL from where APIs will be accessible, for local development it should be localhost:3000/api/app (use your local port number instead) | -| REACT_APP_APPID | opensignstgn | A 12 character long random app identifier. The value of this should be same as APP_ID which is a variable used by backend API. | -| APP_ID | opensignstgn | A 12 character long random app identifier. The value of this should be same as REACT_APP_APPID which is a variable used by Frontend React App. | -| appName | open_sign_server | Name of the app. It will be visible in the verification emails sent out. | -| MASTER_KEY | XnAadwKxxByMr | A 12 character long random secret key that allows access to all the data. It is used in Parse dashboard config to view all the data in the database. | -| MONGODB_URI | mongodb://host.docker.internal:27017/OpenSignDB | Mongodb URI to connect to | -| PARSE_MOUNT |/app | Path on which APIs should be mounted. Do not change this. This variable shall be removed & value hardcoded in the source code in coming versions. | -| SERVER_URL | http://127.0.0.1:8080/app | Set it to the URL from where APIs will be accessible to the NodeJS functions, for local development it should be localhost:3000/api/app (use your local port number instead) | -| DO_SPACE | DOSPACENAME | Digital ocean space name or AWS S3 bucket name for uploading documents | -| DO_ENDPOINT | ams3.digitaloceanspaces.com | Digital ocean spaces endpoint or AWS S3 endpoint for uploading documents | -| DO_BASEURL |https://DOSPACENAME.ams3.digitaloceanspaces.com | Digital ocean baseurl or AWS S3 base URL | -| DO_ACCESS_KEY_ID | YOUR_S3_ACCESS_ID | Digital ocean spaces access key ID or AWS s3 Access key ID for uploading the docs | -| DO_SECRET_ACCESS_KEY | YOUR_S3_ACCESS_KEY | Digital ocean spaces secret access key or AWS s3 secret access key for uploading the docs | -| DO_REGION | YOUR_S3_REGION | Digital ocean spaces region or AWS s3 region | -| USE_LOCAL | FALSE | To use local file storage to save file | -| MAILGUN_API_KEY | YOUR_MAILGUNAPI_KEY | Mailgun API Key | -| MAILGUN_DOMAIN | YOUR_MAILGUNAPI_DOMAIN | Mailgun API Domain | -| MAILGUN_SENDER | - | Mailgun Sender Mail ID | -| PFX_BASE64 | - | Base64 encoded PFX or p12 document signing certificate file. You can generate base64 encoded self sign certificate using the passphrase `emudhra` | - -# Steps to Generate Self Sign Certificate -``` -# execute below command and use passphrase emudhra -openssl genrsa -des3 -out ./cert/local_dev.key 2048 -openssl req -key ./cert/local_dev.key -new -x509 -days 365 -out ./cert/local_dev.crt -openssl pkcs12 -inkey ./cert/local_dev.key -in ./cert/local_dev.crt -export -out ./cert/local_dev.pfx -openssl base64 -in ./cert/local_dev.pfx -out ./cert/base64_pfx -``` - -# CORS Configuration - -As document storage is delegated to S3-compatible services that reside in a different host than the OpenSign one, document operations (loading, storing, deleting) are subject to [Cross-Origin Resource Sharing](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) restriction policies; as a consequence, OpenSign app may fail with (browser console) errors like the following: -``` -Access to fetch at 'https://foo.nyc3.digitaloceanspaces.com/exported_file_4627_0000-00-00T00%3A45%3A43.344Z.pdf' -from origin 'http://localhost:3000' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header -is present on the requested resource. If an opaque response serves your needs, set the request's mode to -'no-cors' to fetch the resource with CORS disabled. -``` - -In order to address this, your document storage system must be instructed to accept requests from other hosts; below the relevant documentation links: -- [How to Configure CORS on DigitalOcean Spaces](https://docs.digitalocean.com/products/spaces/how-to/configure-cors/) -- [Configuring cross-origin resource sharing on AWS S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enabling-cors-examples.html) - -# Build Local Environment - -Command to build project - -- Execute `make build` - -Command to run project - -- Execute `make run` +- Please refer this documentation => [click here](https://docs.opensignlabs.com/docs/self-host/docker/run-locally)