{
  "manifest_version": "1.0.0",
  "template": {
    "id": "078a99d3-9ba6-4509-a52f-4082d1cc4324",
    "slug": "nocodb-airtable",
    "name": "NocoDB | Open Source Airtable Alternative",
    "description": "Self-hosted Airtable alternative — a no-code database over Postgres",
    "url": "https://railway.com/deploy/nocodb-airtable",
    "upstream": {
      "image": "nocodb/nocodb:2026.08.2"
    }
  },
  "services": [
    {
      "name": "NocoDB Worker",
      "source": {
        "image": "nocodb/nocodb:2026.08.2"
      },
      "needs_volume": false,
      "http": false
    },
    {
      "name": "NocoDB",
      "source": {
        "image": "nocodb/nocodb:2026.08.2"
      },
      "needs_volume": false,
      "http": true
    },
    {
      "name": "Postgres",
      "source": {
        "image": "postgres:18.6-alpine"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/postgresql/data",
      "http": false
    },
    {
      "name": "Valkey",
      "source": {
        "image": "valkey/valkey:8.1.10-alpine"
      },
      "needs_volume": false,
      "http": false
    }
  ],
  "required_inputs": [
    {
      "key": "NC_DB",
      "service": "NocoDB Worker",
      "description": "Postgres connection over the private network (NocoDB's pg://host:port?u=&p=&d= form). No SSL, no public proxy. NocoDB requires Postgres for a production deployment.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "NC_REDIS_URL",
      "service": "NocoDB Worker",
      "description": "Valkey/Redis connection over the private network — used for the cache and the background-job queue the worker consumes. No family hint: NocoDB hands this straight to ioredis, which resolves the private IPv6 address on its own.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "NC_S3_REGION",
      "service": "NocoDB Worker",
      "description": "Bucket region.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NC_PUBLIC_URL",
      "service": "NocoDB Worker",
      "description": "Same public URL as the web service (referenced from it), so links the worker generates match.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NC_S3_ENDPOINT",
      "service": "NocoDB Worker",
      "description": "Object-storage endpoint (the Railway bucket).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NC_DISABLE_TELE",
      "service": "NocoDB Worker",
      "description": "Anonymous usage telemetry off by default. Set to false to opt back in.",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "NC_S3_ACCESS_KEY",
      "service": "NocoDB Worker",
      "description": "Bucket access key.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NC_S3_BUCKET_NAME",
      "service": "NocoDB Worker",
      "description": "Railway object-storage bucket for attachments and avatars.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NC_AUTH_JWT_SECRET",
      "service": "NocoDB Worker",
      "description": "Referenced from the NocoDB web service so both sign and validate tokens with the same key.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NC_S3_ACCESS_SECRET",
      "service": "NocoDB Worker",
      "description": "Bucket secret key.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NC_WORKER_CONTAINER",
      "service": "NocoDB Worker",
      "description": "Runs this container in worker mode: no HTTP server, it pulls background jobs (Airtable/CSV imports, webhook delivery, long operations) off the Valkey queue.",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "NC_S3_FORCE_PATH_STYLE",
      "service": "NocoDB Worker",
      "description": "Keep this on. NocoDB signs presigned URLs the browser fetches directly, and Railway storage only sends CORS headers on the path-style (host/bucket/key) endpoint — with virtual-hosted URLs every attachment fails in the browser while curl still reports 200.",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "PORT",
      "service": "NocoDB",
      "description": "Port the NocoDB server listens on. Railway routes traffic and the health check here.",
      "secret": false,
      "strategy": "default",
      "default": "8080"
    },
    {
      "key": "NC_DB",
      "service": "NocoDB",
      "description": "Postgres connection over the private network (NocoDB's pg://host:port?u=&p=&d= form). No SSL, no public proxy. NocoDB requires Postgres for a production deployment.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "NC_REDIS_URL",
      "service": "NocoDB",
      "description": "Valkey/Redis connection over the private network — used for the cache and the background-job queue the worker consumes. No family hint: NocoDB hands this straight to ioredis, which resolves the private IPv6 address on its own.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "NC_S3_REGION",
      "service": "NocoDB",
      "description": "Bucket region.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NC_PUBLIC_URL",
      "service": "NocoDB",
      "description": "Public URL of this instance — used for share links, invite emails and attachment URLs. Set it to your own domain if you add one.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "NC_S3_ENDPOINT",
      "service": "NocoDB",
      "description": "Object-storage endpoint (the Railway bucket).",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NC_DISABLE_TELE",
      "service": "NocoDB",
      "description": "Anonymous usage telemetry off by default. Set to false to opt back in.",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "NC_S3_ACCESS_KEY",
      "service": "NocoDB",
      "description": "Bucket access key.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NC_S3_BUCKET_NAME",
      "service": "NocoDB",
      "description": "Railway object-storage bucket for attachments and avatars.",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NC_AUTH_JWT_SECRET",
      "service": "NocoDB",
      "description": "Signs session tokens. Generated once; changing it logs everyone out.",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "NC_S3_ACCESS_SECRET",
      "service": "NocoDB",
      "description": "Bucket secret key.",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "NC_S3_FORCE_PATH_STYLE",
      "service": "NocoDB",
      "description": "Keep this on. NocoDB signs presigned URLs the browser fetches directly, and Railway storage only sends CORS headers on the path-style (host/bucket/key) endpoint — with virtual-hosted URLs every attachment fails in the browser while curl still reports 200.",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "PGDATA",
      "service": "Postgres",
      "description": "Postgres data directory, one level below the mount point so the volume's lost+found never blocks initialisation.",
      "secret": false,
      "strategy": "default",
      "default": "/var/lib/postgresql/data/pgdata"
    },
    {
      "key": "POSTGRES_DB",
      "service": "Postgres",
      "description": "Database NocoDB uses; the NC_DB connection string points at this name.",
      "secret": false,
      "strategy": "default",
      "default": "nocodb"
    },
    {
      "key": "POSTGRES_USER",
      "service": "Postgres",
      "description": "Database user created on first boot.",
      "secret": false,
      "strategy": "default",
      "default": "postgres"
    },
    {
      "key": "POSTGRES_PASSWORD",
      "service": "Postgres",
      "description": "Database password, generated once. It is embedded in NC_DB's query string, so letters and digits only.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "REDIS_PASSWORD",
      "service": "Valkey",
      "description": "Valkey password, generated once. Embedded in NC_REDIS_URL, so letters and digits only. Valkey is a drop-in Redis fork; NocoDB connects to it exactly as it would to Redis.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "nocodb-airtable"
      }
    },
    "cli": "railway deploy --template nocodb-airtable",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "078a99d3-9ba6-4509-a52f-4082d1cc4324",
            "serializedConfig": {
              "buckets": {
                "da89d8fb-f268-4c56-8e40-b814e10f9a4d": {
                  "name": "Attachments"
                }
              },
              "services": {
                "25c9b16d-7b6f-42f0-9a27-7d3ddc113720": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/nocodb.svg",
                  "name": "NocoDB Worker",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "nocodb/nocodb:2026.08.2"
                  },
                  "variables": {
                    "NC_DB": {
                      "isOptional": false,
                      "description": "Postgres connection over the private network (NocoDB's pg://host:port?u=&p=&d= form). No SSL, no public proxy. NocoDB requires Postgres for a production deployment.",
                      "defaultValue": "pg://${{Postgres.RAILWAY_PRIVATE_DOMAIN}}:5432?u=postgres&p=${{Postgres.POSTGRES_PASSWORD}}&d=nocodb"
                    },
                    "NC_REDIS_URL": {
                      "isOptional": false,
                      "description": "Valkey/Redis connection over the private network — used for the cache and the background-job queue the worker consumes. No family hint: NocoDB hands this straight to ioredis, which resolves the private IPv6 address on its own.",
                      "defaultValue": "redis://default:${{Valkey.REDIS_PASSWORD}}@${{Valkey.RAILWAY_PRIVATE_DOMAIN}}:6379"
                    },
                    "NC_S3_REGION": {
                      "isOptional": false,
                      "description": "Bucket region.",
                      "defaultValue": "${{Attachments.REGION}}"
                    },
                    "NC_PUBLIC_URL": {
                      "isOptional": false,
                      "description": "Same public URL as the web service (referenced from it), so links the worker generates match.",
                      "defaultValue": "${{NocoDB.NC_PUBLIC_URL}}"
                    },
                    "NC_S3_ENDPOINT": {
                      "isOptional": false,
                      "description": "Object-storage endpoint (the Railway bucket).",
                      "defaultValue": "${{Attachments.ENDPOINT}}"
                    },
                    "NC_DISABLE_TELE": {
                      "isOptional": false,
                      "description": "Anonymous usage telemetry off by default. Set to false to opt back in.",
                      "defaultValue": "true"
                    },
                    "NC_S3_ACCESS_KEY": {
                      "isOptional": false,
                      "description": "Bucket access key.",
                      "defaultValue": "${{Attachments.ACCESS_KEY_ID}}"
                    },
                    "NC_S3_BUCKET_NAME": {
                      "isOptional": false,
                      "description": "Railway object-storage bucket for attachments and avatars.",
                      "defaultValue": "${{Attachments.BUCKET}}"
                    },
                    "NC_AUTH_JWT_SECRET": {
                      "isOptional": false,
                      "description": "Referenced from the NocoDB web service so both sign and validate tokens with the same key.",
                      "defaultValue": "${{NocoDB.NC_AUTH_JWT_SECRET}}"
                    },
                    "NC_S3_ACCESS_SECRET": {
                      "isOptional": false,
                      "description": "Bucket secret key.",
                      "defaultValue": "${{Attachments.SECRET_ACCESS_KEY}}"
                    },
                    "NC_WORKER_CONTAINER": {
                      "isOptional": false,
                      "description": "Runs this container in worker mode: no HTTP server, it pulls background jobs (Airtable/CSV imports, webhook delivery, long operations) off the Valkey queue.",
                      "defaultValue": "true"
                    },
                    "NC_S3_FORCE_PATH_STYLE": {
                      "isOptional": false,
                      "description": "Keep this on. NocoDB signs presigned URLs the browser fetches directly, and Railway storage only sends CORS headers on the path-style (host/bucket/key) endpoint — with virtual-hosted URLs every attachment fails in the browser while curl still reports 200.",
                      "defaultValue": "true"
                    }
                  }
                },
                "411216ff-008f-4fea-b3aa-a001a4793418": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/nocodb.svg",
                  "name": "NocoDB",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": "/api/v1/health",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "nocodb/nocodb:2026.08.2"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "Port the NocoDB server listens on. Railway routes traffic and the health check here.",
                      "defaultValue": "8080"
                    },
                    "NC_DB": {
                      "isOptional": false,
                      "description": "Postgres connection over the private network (NocoDB's pg://host:port?u=&p=&d= form). No SSL, no public proxy. NocoDB requires Postgres for a production deployment.",
                      "defaultValue": "pg://${{Postgres.RAILWAY_PRIVATE_DOMAIN}}:5432?u=postgres&p=${{Postgres.POSTGRES_PASSWORD}}&d=nocodb"
                    },
                    "NC_REDIS_URL": {
                      "isOptional": false,
                      "description": "Valkey/Redis connection over the private network — used for the cache and the background-job queue the worker consumes. No family hint: NocoDB hands this straight to ioredis, which resolves the private IPv6 address on its own.",
                      "defaultValue": "redis://default:${{Valkey.REDIS_PASSWORD}}@${{Valkey.RAILWAY_PRIVATE_DOMAIN}}:6379"
                    },
                    "NC_S3_REGION": {
                      "isOptional": false,
                      "description": "Bucket region.",
                      "defaultValue": "${{Attachments.REGION}}"
                    },
                    "NC_PUBLIC_URL": {
                      "isOptional": false,
                      "description": "Public URL of this instance — used for share links, invite emails and attachment URLs. Set it to your own domain if you add one.",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "NC_S3_ENDPOINT": {
                      "isOptional": false,
                      "description": "Object-storage endpoint (the Railway bucket).",
                      "defaultValue": "${{Attachments.ENDPOINT}}"
                    },
                    "NC_DISABLE_TELE": {
                      "isOptional": false,
                      "description": "Anonymous usage telemetry off by default. Set to false to opt back in.",
                      "defaultValue": "true"
                    },
                    "NC_S3_ACCESS_KEY": {
                      "isOptional": false,
                      "description": "Bucket access key.",
                      "defaultValue": "${{Attachments.ACCESS_KEY_ID}}"
                    },
                    "NC_S3_BUCKET_NAME": {
                      "isOptional": false,
                      "description": "Railway object-storage bucket for attachments and avatars.",
                      "defaultValue": "${{Attachments.BUCKET}}"
                    },
                    "NC_AUTH_JWT_SECRET": {
                      "isOptional": false,
                      "description": "Signs session tokens. Generated once; changing it logs everyone out.",
                      "defaultValue": "{{NC_AUTH_JWT_SECRET}}"
                    },
                    "NC_S3_ACCESS_SECRET": {
                      "isOptional": false,
                      "description": "Bucket secret key.",
                      "defaultValue": "${{Attachments.SECRET_ACCESS_KEY}}"
                    },
                    "NC_S3_FORCE_PATH_STYLE": {
                      "isOptional": false,
                      "description": "Keep this on. NocoDB signs presigned URLs the browser fetches directly, and Railway storage only sends CORS headers on the path-style (host/bucket/key) endpoint — with virtual-hosted URLs every attachment fails in the browser while curl still reports 200.",
                      "defaultValue": "true"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:8080": {
                        "port": 8080
                      }
                    }
                  }
                },
                "950fded7-01a0-4b84-9149-2f66c86e60fd": {
                  "icon": null,
                  "name": "Postgres",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 2
                  },
                  "source": {
                    "image": "postgres:18.6-alpine"
                  },
                  "variables": {
                    "PGDATA": {
                      "isOptional": false,
                      "description": "Postgres data directory, one level below the mount point so the volume's lost+found never blocks initialisation.",
                      "defaultValue": "/var/lib/postgresql/data/pgdata"
                    },
                    "POSTGRES_DB": {
                      "isOptional": false,
                      "description": "Database NocoDB uses; the NC_DB connection string points at this name.",
                      "defaultValue": "nocodb"
                    },
                    "POSTGRES_USER": {
                      "isOptional": false,
                      "description": "Database user created on first boot.",
                      "defaultValue": "postgres"
                    },
                    "POSTGRES_PASSWORD": {
                      "isOptional": false,
                      "description": "Database password, generated once. It is embedded in NC_DB's query string, so letters and digits only.",
                      "defaultValue": "{{POSTGRES_PASSWORD}}"
                    }
                  },
                  "volumeMounts": {
                    "950fded7-01a0-4b84-9149-2f66c86e60fd": {
                      "mountPath": "/var/lib/postgresql/data"
                    }
                  }
                },
                "bb297cf9-abf9-473a-8c49-da0e314b9c51": {
                  "icon": null,
                  "name": "Valkey",
                  "deploy": {
                    "startCommand": "sh -c 'exec valkey-server --requirepass \"$REDIS_PASSWORD\"'",
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "valkey/valkey:8.1.10-alpine"
                  },
                  "variables": {
                    "REDIS_PASSWORD": {
                      "isOptional": false,
                      "description": "Valkey password, generated once. Embedded in NC_REDIS_URL, so letters and digits only. Valkey is a drop-in Redis fork; NocoDB connects to it exactly as it would to Redis.",
                      "defaultValue": "{{REDIS_PASSWORD}}"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "NocoDB",
      "method": "GET",
      "path": "/api/v1/health",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 4,
    "needs_volume": true
  },
  "generated_at": "2026-09-20T04:14:40.089Z",
  "generator_version": "0.1.0",
  "status": "degraded",
  "validated_at": "2026-09-19T19:00:26.502Z",
  "success_rate_30d": 0.1667,
  "validation": {
    "last_run_id": "run_3c78ff2de79349c49e1b",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": false,
        "detail": "Your workspace has been restricted. Please contact support to resolve this."
      }
    ],
    "typical_ready_seconds": 173,
    "typical_build_seconds": 0,
    "typical_start_seconds": 20,
    "slowest_service": "NocoDB Worker"
  }
}
