Claude Code Plugins

Community-maintained marketplace

Feedback

railway

@eighttrigrams/personalist
2
0

Railway commands applicable and useful for this project

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name railway
description Railway commands applicable and useful for this project

Railway commands for deploying and managing the personalist application.

Commonly Used Commands

Deploy

railway up --service personalist

Deploy the current codebase to Railway's personalist service.

View Logs

railway logs --service personalist

Stream logs from the personalist service. Use with grep/tail to filter:

railway logs --service personalist 2>&1 | grep "S3" | tail -20
railway logs --service personalist 2>&1 | tail -50

Manage Environment Variables

railway variables --service personalist

View or manage environment variables for the personalist service.

Service Management

railway service

Link to or select a service. Use when Railway commands show "No service could be found."

Important Notes

  • Always use --service personalist flag for service-specific commands
  • The railway status command does NOT support --service flag
  • Logs are streamed in real-time and can be piped to other commands
  • When grepping logs, use 2>&1 to include stderr: railway logs --service personalist 2>&1 | grep "pattern"

Restart vs Redeploy

Important distinction:

  • Restart: Restarts the process in the same container. Container filesystem is preserved (including non-volume paths).
  • Redeploy: Creates a new container from the image. Only mounted volumes persist; everything else is reset.

Implication: Any data stored outside the volume mount path (/app/data) will be lost on redeploy but retained on restart.

Current Service Configuration

  • Service Name: personalist
  • Region: AWS eu-north-1 (Europe Stockholm)
  • Port: 8080
  • Host: 0.0.0.0
  • Volume: /data (persistent storage for XTDB log)

Environment Variables (Production)

Application Variables

  • ADMIN_PASSWORD: Required for production mode
  • HOST: 0.0.0.0
  • PORT: 8080

AWS S3 Variables

  • AWS_ACCESS_KEY_ID: AWS credentials for S3 access
  • AWS_SECRET_ACCESS_KEY: AWS credentials for S3 access
  • AWS_REGION: eu-north-1
  • S3_BUCKET: personalist
  • S3_PREFIX: personalist/

Railway-Provided Variables

Railway automatically sets these variables:

  • RAILWAY_ENVIRONMENT: Current environment (e.g., "production")
  • RAILWAY_SERVICE_NAME: Service name (e.g., "personalist")
  • RAILWAY_PROJECT_NAME: Project name
  • RAILWAY_VOLUME_MOUNT_PATH: Volume mount path (e.g., "/app/data")
  • RAILWAY_PUBLIC_DOMAIN: Public domain for the service

Use RAILWAY_ENVIRONMENT to detect if running on Railway (similar to FLY_APP_NAME for Fly.io).