{
  "manifest_version": "1.0.0",
  "template": {
    "id": "af9dca73-965f-45c5-9799-d12048155a61",
    "slug": "helpdesk",
    "name": "Helpdesk | Frappe's Open-Source Zendesk Alternative",
    "description": "Frappe Helpdesk: ticketing, SLAs, agent portal and nightly backups",
    "url": "https://railway.com/deploy/helpdesk",
    "upstream": {
      "repo_url": "https://github.com/two-workspaces/erpnext"
    }
  },
  "status": "unvalidated",
  "validated_at": null,
  "success_rate_30d": null,
  "services": [
    {
      "name": "MariaDB",
      "source": {
        "image": "mariadb:11.8.9"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/mysql",
      "http": false
    },
    {
      "name": "Helpdesk",
      "source": {
        "repo": "https://github.com/two-workspaces/erpnext"
      },
      "needs_volume": true,
      "volume_mount_path": "/home/frappe/frappe-bench/sites",
      "http": true
    }
  ],
  "required_inputs": [
    {
      "key": "MARIADB_ROOT_PASSWORD",
      "service": "MariaDB",
      "description": "Auto-generated root password",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "MariaDB",
      "description": "Time for MariaDB to shut down cleanly on redeploy",
      "secret": false,
      "strategy": "default",
      "default": "60"
    },
    {
      "key": "PORT",
      "service": "Helpdesk",
      "description": "Port nginx listens on in front of Helpdesk - leave as is",
      "secret": false,
      "strategy": "default",
      "default": "8080"
    },
    {
      "key": "DB_HOST",
      "service": "Helpdesk",
      "description": "MariaDB host - private network only, leave as is",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "DB_PORT",
      "service": "Helpdesk",
      "description": "MariaDB port",
      "secret": false,
      "strategy": "default",
      "default": "3306"
    },
    {
      "key": "S3_BUCKET",
      "service": "Helpdesk",
      "description": "Backup bucket name. Empty = no nightly backups",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "S3_REGION",
      "service": "Helpdesk",
      "description": "Backup bucket region",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "ERPNEXT_URL",
      "service": "Helpdesk",
      "description": "Public URL for links in emails and PDFs - set it to your custom domain when you add one",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "FRAPPE_APPS",
      "service": "Helpdesk",
      "description": "Frappe apps built into the image - leave as is",
      "secret": false,
      "strategy": "default",
      "default": "telephony helpdesk"
    },
    {
      "key": "S3_ENDPOINT",
      "service": "Helpdesk",
      "description": "Nightly backups go to the bundled bucket - leave as is",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "DB_ROOT_PASSWORD",
      "service": "Helpdesk",
      "description": "MariaDB root password, used to create the site's database - leave as is",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "S3_ACCESS_KEY_ID",
      "service": "Helpdesk",
      "description": "Backup bucket credentials",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "FRAPPE_INSTALL_APPS",
      "service": "Helpdesk",
      "description": "Apps installed on the site - leave as is",
      "secret": false,
      "strategy": "default",
      "default": "helpdesk"
    },
    {
      "key": "S3_SECRET_ACCESS_KEY",
      "service": "Helpdesk",
      "description": "Backup bucket credentials",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "ERPNEXT_ADMIN_PASSWORD",
      "service": "Helpdesk",
      "description": "Password for the 'Administrator' login, set on first boot only - change it in Helpdesk afterwards",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "RAILWAY_HEALTHCHECK_TIMEOUT_SEC",
      "service": "Helpdesk",
      "description": "First boot creates the site before the health check can pass",
      "secret": false,
      "strategy": "default",
      "default": "600"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "Helpdesk",
      "description": "Time to finish running jobs and save the job queue on redeploy",
      "secret": false,
      "strategy": "default",
      "default": "30"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "helpdesk"
      }
    },
    "cli": "railway deploy --template helpdesk",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "af9dca73-965f-45c5-9799-d12048155a61",
            "serializedConfig": {
              "buckets": {
                "67d221c5-f70d-436a-9bdc-a8fd21490d85": {
                  "name": "Backups"
                }
              },
              "services": {
                "3ccc15d9-0c9c-4585-ae82-2bacc7797490": {
                  "icon": "https://raw.githubusercontent.com/devicons/devicon/master/icons/mariadb/mariadb-original.svg",
                  "name": "MariaDB",
                  "build": {},
                  "deploy": {
                    "startCommand": "docker-entrypoint.sh mariadbd --datadir=/var/lib/mysql/data --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --skip-character-set-client-handshake",
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "mariadb:11.8.9"
                  },
                  "variables": {
                    "MARIADB_ROOT_PASSWORD": {
                      "isOptional": false,
                      "description": "Auto-generated root password",
                      "defaultValue": "{{MARIADB_ROOT_PASSWORD}}"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": false,
                      "description": "Time for MariaDB to shut down cleanly on redeploy",
                      "defaultValue": "60"
                    }
                  },
                  "networking": {
                    "serviceDomains": {}
                  },
                  "volumeMounts": {
                    "3ccc15d9-0c9c-4585-ae82-2bacc7797490": {
                      "mountPath": "/var/lib/mysql"
                    }
                  }
                },
                "ad36ccdc-8dbe-4550-a3fc-a359d5372160": {
                  "icon": "https://raw.githubusercontent.com/frappe/helpdesk/main/.github/hd-logo.svg",
                  "name": "Helpdesk",
                  "build": {
                    "dockerfilePath": "Dockerfile"
                  },
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": "/api/method/ping",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "https://github.com/two-workspaces/erpnext",
                    "rootDirectory": "/"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "Port nginx listens on in front of Helpdesk - leave as is",
                      "defaultValue": "8080"
                    },
                    "DB_HOST": {
                      "isOptional": false,
                      "description": "MariaDB host - private network only, leave as is",
                      "defaultValue": "${{MariaDB.RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "DB_PORT": {
                      "isOptional": false,
                      "description": "MariaDB port",
                      "defaultValue": "3306"
                    },
                    "S3_BUCKET": {
                      "isOptional": true,
                      "description": "Backup bucket name. Empty = no nightly backups",
                      "defaultValue": "${{Backups.BUCKET}}"
                    },
                    "S3_REGION": {
                      "isOptional": true,
                      "description": "Backup bucket region",
                      "defaultValue": "${{Backups.REGION}}"
                    },
                    "ERPNEXT_URL": {
                      "isOptional": false,
                      "description": "Public URL for links in emails and PDFs - set it to your custom domain when you add one",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "FRAPPE_APPS": {
                      "isOptional": false,
                      "description": "Frappe apps built into the image - leave as is",
                      "defaultValue": "telephony helpdesk"
                    },
                    "S3_ENDPOINT": {
                      "isOptional": true,
                      "description": "Nightly backups go to the bundled bucket - leave as is",
                      "defaultValue": "${{Backups.ENDPOINT}}"
                    },
                    "DB_ROOT_PASSWORD": {
                      "isOptional": false,
                      "description": "MariaDB root password, used to create the site's database - leave as is",
                      "defaultValue": "${{MariaDB.MARIADB_ROOT_PASSWORD}}"
                    },
                    "S3_ACCESS_KEY_ID": {
                      "isOptional": true,
                      "description": "Backup bucket credentials",
                      "defaultValue": "${{Backups.ACCESS_KEY_ID}}"
                    },
                    "ERPNEXT_BG_WORKERS": {
                      "isOptional": true,
                      "description": "Background job workers. Empty = auto: 2, or 1 on plans under 2 GB RAM",
                      "defaultValue": ""
                    },
                    "ERPNEXT_WEB_WORKERS": {
                      "isOptional": true,
                      "description": "Web worker processes (4 threads each). Empty = auto: 2, or 1 on plans under 2 GB RAM",
                      "defaultValue": ""
                    },
                    "FRAPPE_INSTALL_APPS": {
                      "isOptional": false,
                      "description": "Apps installed on the site - leave as is",
                      "defaultValue": "helpdesk"
                    },
                    "S3_SECRET_ACCESS_KEY": {
                      "isOptional": true,
                      "description": "Backup bucket credentials",
                      "defaultValue": "${{Backups.SECRET_ACCESS_KEY}}"
                    },
                    "ERPNEXT_ADMIN_PASSWORD": {
                      "isOptional": false,
                      "description": "Password for the 'Administrator' login, set on first boot only - change it in Helpdesk afterwards",
                      "defaultValue": "{{ERPNEXT_ADMIN_PASSWORD}}"
                    },
                    "RAILWAY_HEALTHCHECK_TIMEOUT_SEC": {
                      "isOptional": false,
                      "description": "First boot creates the site before the health check can pass",
                      "defaultValue": "600"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": false,
                      "description": "Time to finish running jobs and save the job queue on redeploy",
                      "defaultValue": "30"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>": {}
                    }
                  },
                  "volumeMounts": {
                    "ad36ccdc-8dbe-4550-a3fc-a359d5372160": {
                      "mountPath": "/home/frappe/frappe-bench/sites"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "Helpdesk",
      "method": "GET",
      "path": "/api/method/ping",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 2,
    "needs_volume": true
  },
  "generated_at": "2026-10-28T16:14:58.566Z",
  "generator_version": "0.1.0"
}