Add Ubuntu production deployment script and documentation

This commit is contained in:
nmemmert committed 2025-11-06 10:02:38 -05:00
1 parent a4b8a5c728
commit d1a94d3378
3 files changed
+199

No files matched your search

+36
View File
@@ -114,6 +114,42 @@ Users can choose their preferred login method on the login page.
- All processing happens server-side with temporary file storage
- Maximum upload size is limited to 100MB
## Production Deployment
For production deployment on Ubuntu with reverse proxy:
1. **Run the automated installation script**:
```bash
# On your Ubuntu server
wget https://gitlab.com/trbc-dev/pdf-rename-sort/-/raw/main/ubuntu-install.sh
chmod +x ubuntu-install.sh
sudo ./ubuntu-install.sh
```
2. **Configure environment variables**:
Edit `/etc/systemd/system/pdf-renamer.service` and update:
- `SECRET_KEY`: Generate a secure random key
- `TENANT_ID`, `CLIENT_ID`, `CLIENT_SECRET`: From Azure AD app registration
- `ADMIN_USERNAME` and `ADMIN_PASSWORD`: Set secure credentials
3. **Update domain configuration**:
Edit `/etc/nginx/sites-available/pdf-renamer` and replace `your-domain.com` with your actual domain
4. **Enable SSL (recommended)**:
```bash
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com
```
5. **Reload services**:
```bash
sudo systemctl daemon-reload
sudo systemctl restart pdf-renamer
sudo systemctl reload nginx
```
The application will be accessible at your domain on ports 80 (HTTP) and 443 (HTTPS after SSL setup).
## Development
To contribute or modify: