Deploy and Host SkillHub on Railway

About Hosting

SkillHub is an enterprise-grade, open-source skill registry for AI agent ecosystems. Teams can publish, version, discover, and govern skill packages in private namespaces with RBAC, auditability, and API token workflows.

This Railway template deploys SkillHub as a multi-service architecture aligned with upstream runtime expectations:

skillhub-web (Nginx-based frontend, public)
skillhub-server (Spring Boot backend, private)
Postgres (managed database, private)
Redis (managed cache/session store, private)

Images are pinned to upstream release tag v0.1.0 for deterministic deployments.

Why Deploy

Private registry ownership: Keep proprietary skills, metadata, and governance inside your own infrastructure.
Enterprise controls: RBAC, namespace-level workflows, audit logs, and API token support.
Production-like topology: Separate web/backend/data tiers with private service networking.
Deterministic release pinning: Uses v0.1.0 upstream images instead of floating latest.
Template-ready rollout: One-click reusable template for teams and environments.

Common Use Cases

Internal organization-wide skill marketplace for agent teams.
Governed skill publishing workflow with admin review and namespace isolation.
Self-hosted backend for CLI-driven skill distribution.
Private replacement for public skill registries in regulated environments.

Dependencies for Deployment

Deployment Dependencies

Dependency	Details
Web Image	`ghcr.io/iflytek/skillhub-web:v0.1.0`
Server Image	`ghcr.io/iflytek/skillhub-server:v0.1.0`
Database	Railway managed PostgreSQL (`Postgres` service)
Cache	Railway managed Redis (`Redis` service)
Public Port	`web` service on `80` (`PORT=80`)
Backend Port	`server` service on `8080`
Persistent Volume	Managed by Railway Postgres/Redis services
Required Server Vars	`SPRING_PROFILES_ACTIVE`, datasource vars, redis vars (including `REDIS_PASSWORD`), storage provider, bootstrap admin vars
Required Web Vars	`SKILLHUB_API_UPSTREAM`, `SKILLHUB_PUBLIC_BASE_URL`, `PORT`
Private Networking	`server` connects to `${{Postgres.PGHOST}}` and `${{Redis.REDISHOST}}`

Operational Notes

Expose only skillhub-web publicly. Keep skillhub-server, Postgres, and Redis private.
Set SKILLHUB_PUBLIC_BASE_URL in web as https://${{RAILWAY_PUBLIC_DOMAIN}}, and in server as https://${{skillhub-web.RAILWAY_PUBLIC_DOMAIN}}.
BOOTSTRAP_ADMIN_ENABLED=true is provided for first login. Rotate credentials and disable bootstrap admin after initialization.
Default storage provider in this template is local for quick startup. Move to S3-compatible storage for production durability.