{
  "manifest_version": "1.0.0",
  "template": {
    "id": "1b8e1db8-817f-4181-92a8-abf28be3e010",
    "slug": "mailcheap",
    "name": "Mailcheap",
    "description": "Self-hosted newsletters on Amazon SES with image uploads on Railway.",
    "url": "https://railway.com/deploy/mailcheap",
    "upstream": {
      "repo_url": "https://github.com/aimranov27/mailcheap-railway"
    }
  },
  "status": "unvalidated",
  "validated_at": null,
  "success_rate_30d": null,
  "services": [
    {
      "name": "Mailcheap",
      "source": {
        "repo": "https://github.com/aimranov27/mailcheap-railway"
      },
      "needs_volume": true,
      "volume_mount_path": "/data",
      "http": true
    },
    {
      "name": "MongoDB",
      "source": {
        "image": "mongo:8.2"
      },
      "needs_volume": true,
      "volume_mount_path": "/data/db",
      "http": false
    }
  ],
  "required_inputs": [
    {
      "key": "APP_URL",
      "service": "Mailcheap",
      "description": "Public URL used in email links and image URLs. Update it before your first send if you add your own domain.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "SES_REGION",
      "service": "Mailcheap",
      "description": "AWS region of your SES account.",
      "secret": false,
      "strategy": "default",
      "default": "us-east-1"
    },
    {
      "key": "ADMIN_EMAIL",
      "service": "Mailcheap",
      "description": "Your email address. It is the dashboard login, and test emails and alerts are sent to it.",
      "secret": false,
      "strategy": "ask_user"
    },
    {
      "key": "MONGODB_URI",
      "service": "Mailcheap",
      "description": "Connection string for the MongoDB service, with the mailcheap database.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "ADMIN_PASSWORD",
      "service": "Mailcheap",
      "description": "Dashboard password, generated for you. At least 12 characters. Changing it signs out every session.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "SESSION_SECRET",
      "service": "Mailcheap",
      "description": "Signs logins and every link in your emails. Generated for you. Changing it after your first send breaks unsubscribe links in emails already sent.",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "SENDING_ENABLED",
      "service": "Mailcheap",
      "description": "Nothing is sent until this is true. Set it to true after the SES and QStash variables are filled in.",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "MONGOHOST",
      "service": "MongoDB",
      "description": "Railway Private Domain Name.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "MONGOPORT",
      "service": "MongoDB",
      "description": "MongoDB Port.",
      "secret": false,
      "strategy": "default",
      "default": "27017"
    },
    {
      "key": "MONGOUSER",
      "service": "MongoDB",
      "description": "Mongodb user.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MONGO_URL",
      "service": "MongoDB",
      "description": "Private URL to connect to MongoDB.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "MONGOPASSWORD",
      "service": "MongoDB",
      "description": "Root password.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "MONGO_INITDB_ROOT_PASSWORD",
      "service": "MongoDB",
      "description": "Root user password, set during initialization.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "MONGO_INITDB_ROOT_USERNAME",
      "service": "MongoDB",
      "description": "User created during initialization, given the root role.",
      "secret": false,
      "strategy": "default",
      "default": "mongo"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "mailcheap"
      }
    },
    "cli": "railway deploy --template mailcheap",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "1b8e1db8-817f-4181-92a8-abf28be3e010",
            "serializedConfig": {
              "services": {
                "3e07b961-c532-46a0-b0c3-5117d66fcdb6": {
                  "icon": "https://raw.githubusercontent.com/marclou/mailcheap/67d13b028a6ecae9ec56d49c4b2db58019217eba/app/icon.svg",
                  "name": "Mailcheap",
                  "deploy": {
                    "healthcheckPath": "/login"
                  },
                  "source": {
                    "repo": "aimranov27/mailcheap-railway"
                  },
                  "variables": {
                    "APP_URL": {
                      "isOptional": false,
                      "description": "Public URL used in email links and image URLs. Update it before your first send if you add your own domain.",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "ALERT_FROM": {
                      "isOptional": true,
                      "description": "Optional. From address for alert emails on your verified domain, like Mailcheap alerts@mail.example.com. Empty means alerts only go to the logs.",
                      "defaultValue": ""
                    },
                    "SES_REGION": {
                      "isOptional": false,
                      "description": "AWS region of your SES account.",
                      "defaultValue": "us-east-1"
                    },
                    "ADMIN_EMAIL": {
                      "isOptional": false,
                      "description": "Your email address. It is the dashboard login, and test emails and alerts are sent to it.",
                      "defaultValue": "{{ADMIN_EMAIL}}"
                    },
                    "MONGODB_URI": {
                      "isOptional": false,
                      "description": "Connection string for the MongoDB service, with the mailcheap database.",
                      "defaultValue": "${{MongoDB.MONGO_URL}}/mailcheap?authSource=admin"
                    },
                    "QSTASH_TOKEN": {
                      "isOptional": true,
                      "description": "Optional. Upstash QStash token from console.upstash.com/qstash. Needed to send campaigns and schedule them.",
                      "defaultValue": ""
                    },
                    "ADMIN_PASSWORD": {
                      "isOptional": false,
                      "description": "Dashboard password, generated for you. At least 12 characters. Changing it signs out every session.",
                      "defaultValue": "{{ADMIN_PASSWORD}}"
                    },
                    "SESSION_SECRET": {
                      "isOptional": false,
                      "description": "Signs logins and every link in your emails. Generated for you. Changing it after your first send breaks unsubscribe links in emails already sent.",
                      "defaultValue": "{{SESSION_SECRET}}"
                    },
                    "SENDING_ENABLED": {
                      "isOptional": false,
                      "description": "Nothing is sent until this is true. Set it to true after the SES and QStash variables are filled in.",
                      "defaultValue": "false"
                    },
                    "SES_ACCESS_KEY_ID": {
                      "isOptional": true,
                      "description": "Optional. Access key of the IAM user for SES. Needed to send. Setup steps: github.com/marclou/mailcheap#3-amazon-ses",
                      "defaultValue": ""
                    },
                    "SES_SNS_TOPIC_ARN": {
                      "isOptional": true,
                      "description": "Optional. ARN of the SNS topic for SES events. Subscribe https://your-domain/api/webhooks/ses to it.",
                      "defaultValue": ""
                    },
                    "SES_CONFIGURATION_SET": {
                      "isOptional": true,
                      "description": "Optional. SES configuration set that publishes bounces and complaints to SNS. Needed to send.",
                      "defaultValue": ""
                    },
                    "SES_SECRET_ACCESS_KEY": {
                      "isOptional": true,
                      "description": "Optional. Secret key of the IAM user for SES. Needed to send.",
                      "defaultValue": ""
                    },
                    "QSTASH_NEXT_SIGNING_KEY": {
                      "isOptional": true,
                      "description": "Optional. QStash next signing key.",
                      "defaultValue": ""
                    },
                    "QSTASH_CURRENT_SIGNING_KEY": {
                      "isOptional": true,
                      "description": "Optional. QStash current signing key. Mailcheap checks it on every background job.",
                      "defaultValue": ""
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:8080": {
                        "port": 8080
                      }
                    }
                  },
                  "volumeMounts": {
                    "3e07b961-c532-46a0-b0c3-5117d66fcdb6": {
                      "mountPath": "/data"
                    }
                  }
                },
                "e946d581-fd66-4993-b22a-70f8c3644dd8": {
                  "icon": "https://devicons.railway.app/i/mongodb.svg",
                  "name": "MongoDB",
                  "deploy": {
                    "startCommand": "docker-entrypoint.sh mongod --ipv6 --bind_ip ::,0.0.0.0 --setParameter diagnosticDataCollectionEnabled=false",
                    "requiredMountPath": "/data/db"
                  },
                  "source": {
                    "image": "mongo:8.2"
                  },
                  "variables": {
                    "MONGOHOST": {
                      "isOptional": false,
                      "description": "Railway Private Domain Name.",
                      "defaultValue": "${{ RAILWAY_PRIVATE_DOMAIN }}"
                    },
                    "MONGOPORT": {
                      "isOptional": false,
                      "description": "MongoDB Port.",
                      "defaultValue": "27017"
                    },
                    "MONGOUSER": {
                      "isOptional": false,
                      "description": "Mongodb user.",
                      "defaultValue": "${{ MONGO_INITDB_ROOT_USERNAME }}"
                    },
                    "MONGO_URL": {
                      "isOptional": false,
                      "description": "Private URL to connect to MongoDB.",
                      "defaultValue": "mongodb://${{MONGO_INITDB_ROOT_USERNAME}}:${{MONGO_INITDB_ROOT_PASSWORD}}@${{RAILWAY_PRIVATE_DOMAIN}}:27017"
                    },
                    "MONGOPASSWORD": {
                      "isOptional": false,
                      "description": "Root password.",
                      "defaultValue": "${{ MONGO_INITDB_ROOT_PASSWORD }}"
                    },
                    "MONGO_INITDB_ROOT_PASSWORD": {
                      "isOptional": false,
                      "description": "Root user password, set during initialization.",
                      "defaultValue": "{{MONGO_INITDB_ROOT_PASSWORD}}"
                    },
                    "MONGO_INITDB_ROOT_USERNAME": {
                      "isOptional": false,
                      "description": "User created during initialization, given the root role.",
                      "defaultValue": "mongo"
                    }
                  },
                  "volumeMounts": {
                    "e946d581-fd66-4993-b22a-70f8c3644dd8": {
                      "mountPath": "/data/db"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "Mailcheap",
      "method": "GET",
      "path": "/login",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 2,
    "needs_volume": true
  },
  "generated_at": "2026-10-13T10:14:42.292Z",
  "generator_version": "0.1.0"
}