secubox-openwrt/package/secubox/secubox-app-rezapp/README.md

RezApp Forge

Docker to SecuBox LXC App Converter.

Overview

RezApp Forge converts Docker images into LXC containers and generates SecuBox addon packages. Browse Docker Hub, GHCR, and LinuxServer.io catalogs, convert images to LXC, and publish to the SecuBox app store.

Features

• Catalog Management - Docker Hub, LinuxServer.io, GHCR support
• Docker Search - Search images across all enabled catalogs
• Image Info - View available tags and architectures
• Docker to LXC - Convert Docker images to LXC containers
• Package Generation - Auto-generate SecuBox addon packages
• Catalog Publishing - Add converted apps to SecuBox catalog

Installation

opkg install secubox-app-rezapp

CLI Usage

# Catalog management
rezappctl catalog list              # List enabled catalogs
rezappctl catalog add <name> <url>  # Add custom catalog
rezappctl catalog remove <name>     # Remove catalog

# Search Docker images
rezappctl search <query>            # Search all catalogs
rezappctl search heimdall           # Example: search for heimdall
rezappctl info <image>              # Show image details

# Convert Docker to LXC
rezappctl convert <image> [options]
  --name <app-name>     # Custom app name
  --tag <version>       # Image tag (default: latest)
  --memory <limit>      # Memory limit (default: 512M)

# Generate SecuBox package
rezappctl package <app-name>        # Create package from converted app

# Publish to catalog
rezappctl publish <app-name>        # Add manifest to SecuBox catalog

# List converted apps
rezappctl list                      # Show all converted apps

Example Workflow

# 1. Search for an app
rezappctl search heimdall

# 2. Check available tags
rezappctl info linuxserver/heimdall

# 3. Convert to LXC
rezappctl convert linuxserver/heimdall --name heimdall --memory 512M

# 4. Generate SecuBox package
rezappctl package heimdall

# 5. Publish to catalog
rezappctl publish heimdall

Configuration

UCI config: /etc/config/rezapp

config main 'main'
    option cache_dir '/srv/rezapp/cache'
    option output_dir '/srv/rezapp/generated'
    option apps_dir '/srv/rezapp/apps'
    option lxc_dir '/srv/lxc'
    option default_memory '512M'

config catalog 'dockerhub'
    option name 'Docker Hub'
    option type 'dockerhub'
    option enabled '1'

config catalog 'linuxserver'
    option name 'LinuxServer.io'
    option type 'dockerhub'
    option namespace 'linuxserver'
    option enabled '1'

Conversion Process

1. Pull - Download Docker image
2. Export - Create container and export filesystem
3. Extract - Unpack to LXC rootfs
4. Configure - Generate LXC config from Docker metadata
5. Wrap - Create start script for LXC execution

Generated Package Structure

/srv/rezapp/generated/secubox-app-<name>/
├── Makefile              # OpenWrt package makefile
├── files/
│   ├── etc/config/<name> # UCI configuration
│   ├── etc/init.d/<name> # Procd init script
│   └── usr/sbin/<name>ctl # Management CLI
└── README.md

LuCI Interface

Install luci-app-rezapp for web interface at Services > RezApp Forge.

Dependencies

• docker
• lxc, lxc-common
• curl, wget-ssl
• jsonfilter

File Locations

Path	Description
/etc/config/rezapp	UCI configuration
/usr/sbin/rezappctl	CLI tool
/srv/rezapp/cache/	Downloaded images
/srv/rezapp/apps/	Converted app metadata
/srv/rezapp/generated/	Generated packages
/srv/lxc/<app>/	LXC container rootfs
/usr/share/rezapp/templates/	Package templates

Templates

Templates at /usr/share/rezapp/templates/:

• Makefile.tpl - Package Makefile
• init.d.tpl - Procd init script
• ctl.tpl - Management CLI
• config.tpl - UCI defaults
• start-lxc.tpl - LXC startup wrapper
• lxc-config.tpl - LXC configuration
• manifest.tpl - App catalog manifest