Dorian Niemiec
cb9a35cb2b
Some checks failed
Deploy Next.js application / deploy (push) Failing after 10m4s
91 lines
No EOL
3.1 KiB
Markdown
91 lines
No EOL
3.1 KiB
Markdown
# Deploy with SVR.JS
|
|
|
|
SVR.JS is web server software running on Node.JS. This tutorial will guide you on how to deploy MERNMail application with SVR.JS web server.
|
|
|
|
Follow these steps to install and set up MERNMail with SVR.JS on GNU/Linux systems:
|
|
|
|
## 1. Install SVR.JS
|
|
|
|
First, install SVR.JS:
|
|
|
|
```bash
|
|
curl -fsSL https://downloads.svrjs.org/installer/svr.js.installer.linux.20240509.sh > /tmp/installer.sh && sudo bash /tmp/installer.sh
|
|
```
|
|
|
|
You can also copy the installation command from the [SVR.JS website](https://svrjs.org)
|
|
|
|
## 2. Configure SVR.JS
|
|
|
|
Open the `/etc/svrjs-config.json` file in your preferred text editor, and alter the configuration like this (`wwwroot` webroot property in the SVR.JS configuration serves as MERNMail application root):
|
|
|
|
```json
|
|
{
|
|
"customHeaders": {
|
|
"x-content-type-options": "nosniff",
|
|
"Content-Security-Policy": "default-src 'self'; script-src 'self' 'sha256-VA8O2hAdooB288EpSTrGLl7z3QikbWU9wwoebO/QaYk=' 'sha256-+5XkZFazzJo8n0iOP4ti/cLCMUudTf//Mzkb7xNPXIc=' 'sha256-MS6/3FCg4WjP9gwgaBGwLpRCY6fZBgwmhVCdrPrNf3E=' 'sha256-tQjf8gvb2ROOMapIxFvFAYBeUJ0v1HCbOcSmDNXGtDo='; style-src 'self' 'unsafe-inline'; frame-src 'self' data:",
|
|
"Referrer-Policy": "strict-origin-when-cross-origin",
|
|
"Permissions-Policy": "geolocation=(), camera=(), microphone=(), fullscreen=*",
|
|
"Feature-Policy": "geolocation 'none', camera 'none', microphone 'none', fullscreen *"
|
|
},
|
|
"nonStandardCodes": [
|
|
{
|
|
"scode": 403,
|
|
"regex": "/^\\/\\.env(?:\\.local|\\.production)?(?:$|[#?])/"
|
|
},
|
|
{
|
|
"scode": 403,
|
|
"regex": "/^\\/\\.git/"
|
|
}
|
|
],
|
|
"wwwroot": "/var/lib/mernmail",
|
|
... other configuration options
|
|
}
|
|
```
|
|
|
|
## 3. Set up MERNMail
|
|
|
|
Run these commands to set up MERNMail:
|
|
|
|
```bash
|
|
cd /var/lib
|
|
git clone https://git.svrjs.org/mernmail/mernmail.git
|
|
chown -hR svrjs:svrjs /var/lib/mernmail
|
|
cd mernmail
|
|
sudo runuser svrjs -s /bin/bash -c 'cd /var/lib/mernmail && npm install && npm run build'
|
|
```
|
|
|
|
## 4. Configure MERNMail
|
|
|
|
Copy the `.env.example` file to a `.env` file in the MERNMail root directory (like `/var/lib/mernmail`). The configuration options can be found in the [Configuration](/docs/configuration) page.
|
|
|
|
For additional security, you can set the permissions for the `.env` file using this command:
|
|
```bash
|
|
sudo chmod 600 /var/lib/mernmail/.env
|
|
```
|
|
|
|
## 5. Install MERNMail integration mod
|
|
|
|
Run these commands to install the MERNMail integration mod for SVR.JS (replace `/usr/lib/svrjs` with SVR.JS installation directory):
|
|
|
|
```bash
|
|
cd ~
|
|
git clone https://git.svrjs.org/mernmail/mernmail-svrjs-mod.git
|
|
cd mernmail-svrjs-mod
|
|
npm install
|
|
npm run build
|
|
cp dist/mod.js /usr/lib/svrjs/mods/mernmail.js
|
|
```
|
|
|
|
## 6. Restart SVR.JS
|
|
|
|
Restart SVR.JS using either `sudo systemctl restart svrjs` or `sudo /etc/init.d/svrjs restart` command.
|
|
|
|
## Updating MERNMail
|
|
|
|
To update the MERNMail webmail application, run this command:
|
|
|
|
```bash
|
|
sudo runuser svrjs -s /bin/bash -c 'cd /var/lib/mernmail && git pull && npm install && npm run build'
|
|
```
|
|
|
|
After updating MERNMail, restart SVR.JS using either `sudo systemctl restart svrjs` or `sudo /etc/init.d/svrjs restart` command. |