---
title: "Deploy skillhub"
description: "SkillHub is an enterprise-ready, self-hosted agent skill registry"
category: "AI/ML"
url: https://railway.com/deploy/skillhub
---

# Deploy skillhub

SkillHub is an enterprise-ready, self-hosted agent skill registry

**[Deploy skillhub on Railway](https://railway.com/template/skillhub)**

- **Creator:** kmaki's Projects
- **Category:** AI/ML
- **Total deploys:** 4

## Template content

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2.1
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

### skillhub-web

- **Image:** ghcr.io/iflytek/skillhub-web:v0.1.0
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### skillhub-server

- **Image:** ghcr.io/iflytek/skillhub-server:v0.1.0

## Documentation

# Deploy and Host SkillHub on Railway

## About Hosting

[SkillHub](https://github.com/iflytek/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.


## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [stella](https://railway.com/deploy/stella) — Self-host stella with web, API, Postgres, Redis, and object storage.
- [Hermes Agent | OpenClaw Alternative with Dashboard](https://railway.com/deploy/hermes-agent-or-openclaw-alternative-wit) — Self-Hosted Hermes AI Agent for Telegram, Discord & Slack

Open this page in a browser: https://railway.com/deploy/skillhub