Service: Encore Profile Server - EyevinnOSC/community GitHub Wiki

Encore Profile Server

Encore Profile Server (serviceId grusell-encore-profile-server) is an open source HTTP server that stores and serves SVT Encore transcoding profiles from an S3-compatible object store. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance. Source: grusell/encore-profile-server.

What it can do

  • Serve YAML or JSON Encore profile files stored in a bucket, so profiles can be updated without restarting the transcoding pipeline.
  • List profiles (/profiles) and fetch a profile by name (/profiles/<name>).
  • Generate new profiles from a free-text instruction through the /feelinglucky endpoint using the Anthropic Claude API (requires anthropicApiKey).

Creating an instance

Create first, and confirm running:

  • A MinIO instance (minio-minio), for example { "name": "profilestore", "RootUser": "myuser", "RootPassword": "{{secrets.miniopwd}}" } (the password must be at least 10 characters with lower case, upper case and a digit). Read its internal endpoint with describe-service-instance.
  • A bucket named encore-profiles (or your own name) in MinIO containing your Encore profile YAML/JSON files.
  • An SVT Encore instance that will consume the profiles.

Then create the profile server with create-service-instance and serviceId: "grusell-encore-profile-server":

{
  "name": "myprofileserver",
  "s3Endpoint": "<minio-internal-url>",
  "s3AccessKey": "{{secrets.miniouser}}",
  "s3SecretKey": "{{secrets.miniopwd}}",
  "s3Bucket": "encore-profiles"
}

The catalog associates s3Endpoint with minio-minio over the internal route (http, without credentials or path). Read the instance URL with describe-service-instance. Then configure your Encore instance to use the profile server URL as its profile source; see the SVT Encore documentation for the configuration key.

Options

Option Required Type Meaning
name Yes string Name of the instance. Alphanumeric/word characters only (^\w+$), at most 20 characters.
s3Endpoint No string Endpoint URL of the S3-compatible storage holding the profiles (MinIO, AWS S3, others). Default http://localhost:9000. Use the MinIO internal URL on OSC.
s3Region No string Region identifier of the storage. Default us-east-1.
s3AccessKey No string, sensitive Access key ID for the storage. Default minioadmin. For MinIO this is its RootUser.
s3SecretKey No string, sensitive Secret access key for the storage. Default minioadmin. For MinIO this is its RootPassword.
s3Bucket No string Bucket containing the profile files (YAML/JSON). Default encore-profiles.
s3Prefix No string Path prefix inside the bucket that limits profile discovery, for example prod/profiles. Default empty (whole bucket).
anthropicApiKey No string, sensitive Anthropic API key. Only needed for AI profile generation via /feelinglucky; without it that endpoint does not work.
anthropicModel No string Claude model used by /feelinglucky. Default claude-sonnet-4-5-20250929.

Pass sensitive options as {{secrets.NAME}} (created with create-service-secret); a reference must be the whole field value.

Using the instance

List available profiles:

curl https://<profile-server-url>/profiles

Fetch a specific profile:

curl https://<profile-server-url>/profiles/program

Generate a profile with AI (requires anthropicApiKey):

curl -X POST https://<profile-server-url>/feelinglucky \
  -H "Content-Type: application/json" \
  -d '{"instruction": "Create a profile for 1080p ABR with 3 quality levels targeting streaming"}'

OSC CLI:

# Create a MinIO instance first
osc create minio-minio myprofilestore \
  -o RootUser="myuser" \
  -o RootPassword="mypassword"

# Then create the profile server
osc create grusell-encore-profile-server myprofileserver \
  -o s3Endpoint="<minio-internal-url>" \
  -o s3AccessKey="myuser" \
  -o s3SecretKey="mypassword" \
  -o s3Bucket="encore-profiles"

MinIO options

The storage dependency is service minio-minio (see MinIO). License AGPL-3.0.

Option Required Type Meaning
name Yes string Name of the instance. Alphanumeric/word characters only, at most 20 characters.
RootUser No string Admin user name; the access key ID (AWS_ACCESS_KEY_ID / S3_ACCESS_KEY_ID) for S3 clients. Generated by the system if left empty.
RootPassword No string, sensitive Admin password; the secret access key (AWS_SECRET_ACCESS_KEY / S3_SECRET_ACCESS_KEY) for S3 clients. Must match ^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).{10,}$ (at least 10 characters with a lower case letter, an upper case letter and a digit). Generated by the system if left empty.

Resources

⚠️ **GitHub.com Fallback** ⚠️