[Infrastructure] Deployment - Nginx, Systemd, Subdomain #12

Closed
opened 2026-04-06 00:30:30 +02:00 by shoko · 4 comments
Owner

Overview

Create deployment documentation and templates for deploying the application to a production server with Nginx, systemd, and subdomain configuration.

Approach

Instead of directly configuring the server, this issue creates version-controlled deployment documentation and reusable templates that can be reviewed and applied when ready.

Deliverables

/deployment/DEPLOYMENT.md

Comprehensive documentation covering:

  • Server requirements (Debian, Python 3.10+, Node.js 18+, Nginx, SSL)
  • Step-by-step deployment instructions
  • Nginx configuration template
  • Systemd service template
  • DNS/Firewall setup instructions
  • Troubleshooting guide

/deployment/scripts/ folder

  • nginx-template.conf - Nginx site configuration template
  • systemd-template.service - Systemd service template
  • deploy.sh - Optional automated deployment script

Dependencies

  • Requires Backend Setup (issue #2) - systemd service and nginx proxy point to backend
  • Requires Frontend Setup (issue #9) - closed ✓
  • Requires Frontend Components (issue #10) - nginx serves frontend static files
  • Best done after issues #2 and #10 are completed

Status

This issue creates documentation and templates that can be prepared independently but finalized when dependencies are resolved.

## Overview Create deployment documentation and templates for deploying the application to a production server with Nginx, systemd, and subdomain configuration. ## Approach Instead of directly configuring the server, this issue creates version-controlled deployment documentation and reusable templates that can be reviewed and applied when ready. ## Deliverables ### `/deployment/DEPLOYMENT.md` Comprehensive documentation covering: - Server requirements (Debian, Python 3.10+, Node.js 18+, Nginx, SSL) - Step-by-step deployment instructions - Nginx configuration template - Systemd service template - DNS/Firewall setup instructions - Troubleshooting guide ### `/deployment/scripts/` folder - `nginx-template.conf` - Nginx site configuration template - `systemd-template.service` - Systemd service template - `deploy.sh` - Optional automated deployment script ## Dependencies - Requires **Backend Setup** (issue #2) - systemd service and nginx proxy point to backend - Requires **Frontend Setup** (issue #9) - closed ✓ - Requires **Frontend Components** (issue #10) - nginx serves frontend static files - Best done after issues #2 and #10 are completed ## Status This issue creates documentation and templates that can be prepared independently but finalized when dependencies are resolved.
shoko added this to the Phase 1 - Core MVP milestone 2026-04-06 00:30:30 +02:00
shoko added the infrastructure label 2026-04-06 00:30:30 +02:00

for this issue, I'd like you to create a documentation, let's say DEPLOYMENT.md and put everything there. if there is any script or template script, put them as well. maybe a folder /deployment at root level and then we will have DEPLOYMENT.md and folder scripts for any scripts needed during deployment

for this issue, I'd like you to create a documentation, let's say DEPLOYMENT.md and put everything there. if there is any script or template script, put them as well. maybe a folder /deployment at root level and then we will have DEPLOYMENT.md and folder scripts for any scripts needed during deployment
Author
Owner

@han Thanks for the guidance! I agree this approach makes more sense.

Proposed changes to the issue:

Instead of directly configuring the server via SSH, I will create:

  1. /deployment/DEPLOYMENT.md - Full documentation covering:

    • Server requirements
    • Step-by-step deployment instructions
    • Nginx configuration template
    • Systemd service template
    • DNS/Firewall setup instructions
    • Troubleshooting guide
  2. /deployment/scripts/ folder with:

    • nginx-template.conf - Nginx site configuration template
    • systemd-template.service - Systemd service template
    • deploy.sh - Optional automated deployment script

This approach is better because:

  • Version controlled documentation
  • Reusable templates
  • Can be reviewed before applying
  • Works for future deployments

Does this sound good to you? Should I proceed with this approach?

@han Thanks for the guidance! I agree this approach makes more sense. **Proposed changes to the issue:** Instead of directly configuring the server via SSH, I will create: 1. `/deployment/DEPLOYMENT.md` - Full documentation covering: - Server requirements - Step-by-step deployment instructions - Nginx configuration template - Systemd service template - DNS/Firewall setup instructions - Troubleshooting guide 2. `/deployment/scripts/` folder with: - `nginx-template.conf` - Nginx site configuration template - `systemd-template.service` - Systemd service template - `deploy.sh` - Optional automated deployment script This approach is better because: - Version controlled documentation - Reusable templates - Can be reviewed before applying - Works for future deployments Does this sound good to you? Should I proceed with this approach?

this is sounds good to me, can you update the issue description as well? also does it need another issue to complete first? or this issue can be finished independently?

this is sounds good to me, can you update the issue description as well? also does it need another issue to complete first? or this issue can be finished independently?
Author
Owner

@han Good questions!

Updating issue description: Yes, I will update the issue description to reflect the new approach (creating deployment docs/scripts instead of direct server setup).

Dependencies: Looking at the current status:

  • Issue #2 (Backend Setup) - open
  • Issue #9 (Frontend Setup) - closed
  • Issue #10 (Frontend Components) - open

This issue cannot be fully completed independently because it depends on:

  1. Issue #2 (Backend Setup) - needed because the systemd service and nginx reverse proxy point to the backend
  2. Issue #10 (Frontend Components) - needed because nginx serves the frontend static files

However, I can prepare all the documentation and templates now based on what we know about the project structure. The templates can be created and refined, then applied when the backend/frontend are ready.

Should I proceed with creating the documentation and templates as much as possible? I can make the deployment docs comprehensive enough that they just need minor adjustments when the dependencies are resolved.

@han Good questions! **Updating issue description:** Yes, I will update the issue description to reflect the new approach (creating deployment docs/scripts instead of direct server setup). **Dependencies:** Looking at the current status: - Issue #2 (Backend Setup) - **open** - Issue #9 (Frontend Setup) - **closed** ✓ - Issue #10 (Frontend Components) - **open** This issue **cannot be fully completed independently** because it depends on: 1. Issue #2 (Backend Setup) - needed because the systemd service and nginx reverse proxy point to the backend 2. Issue #10 (Frontend Components) - needed because nginx serves the frontend static files However, I can prepare all the documentation and templates now based on what we know about the project structure. The templates can be created and refined, then applied when the backend/frontend are ready. Should I proceed with creating the documentation and templates as much as possible? I can make the deployment docs comprehensive enough that they just need minor adjustments when the dependencies are resolved.
shoko closed this issue 2026-04-09 01:23:54 +02:00
Sign in to join this conversation.
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: shoko/randebu#12