Sign inSign up

troke12/refity-backend

By troke12

•Updated 4 months ago

The backend of refity

Image
Databases & storage
0

1.9K

troke12/refity-backend repository overview

⁠Refity Backend

Backend service for Refity — a self-hosted Docker private registry with SFTP storage. This image runs the Go server that implements the Docker Registry API v2 and the REST API used by the Refity web UI.

⁠Features

  • Docker Registry API v2 — Full compatibility with docker push and docker pull
  • SFTP backend — All blobs, manifests, and metadata stored on your SFTP server
  • REST API — Auth (JWT), dashboard, groups, repositories, tags, and profile (change password)
  • SQLite — Local metadata and user data; persisted via volume
  • Configurable security — JWT secret, CORS origins, optional SSH host key verification

⁠Quick start

docker run -d \
  -p 5000:5000 \
  -e FTP_HOST=your-sftp.example.com \
  -e FTP_PORT=22 \
  -e FTP_USERNAME=sftpuser \
  -e FTP_PASSWORD=sftppass \
  -e JWT_SECRET=your-secret-min-32-chars \
  -v refity-data:/app/data \
  troke12/refity-backend:latest

⁠Environment variables

VariableRequiredDescription
FTP_HOSTYesSFTP server hostname
FTP_PORTNoSFTP port (default: 22)
FTP_USERNAMEYesSFTP username
FTP_PASSWORDYesSFTP password
JWT_SECRETProductionSecret for JWT signing
CORS_ORIGINSNoComma-separated allowed origins
FTP_KNOWN_HOSTSNoPath to SSH known_hosts file
PORTNoHTTP port (default: 5000)

⁠Documentation

Source & full docs: github.com/troke12/refity⁠

Tag summary

Content type

Image

Digest

sha256:377363324…

Size

13.6 MB

Last updated

4 months ago

docker pull troke12/refity-backend