HUB
Sign inSign up

featurehub/party-server-ish

By featurehub

•Updated 4 months ago

FeatureHub all-in-one, REST only: Admin app, MR and Edge-REST (no NATS/Dacha)

Image
0

10K+

featurehub/party-server-ish repository overview

⁠FeatureHub Party Server-ish

Party Server-ish is the all-in-one, REST-only FeatureHub deployment. A single container runs:

  • the Admin web app (the Flutter admin console)
  • the Management Repository (MR): the admin API and source of truth
  • Edge-REST: the SDK-facing API for GET (polling) and PUT requests, which reads straight from the database

It includes no NATS, no Dacha cache and no streaming (SSE). Because of this it is simple and cheap to run on platforms such as Google Cloud Run, Azure Container Instances or ECS. It suits mobile and web clients that poll for features. See Option 1b – Low Volume Deployment (REST only)⁠.

If you need streaming updates, use party-server⁠. To scale REST traffic across read replicas, split into mr⁠ + edge-rest⁠ (Option 2b⁠).

Full documentation: https://docs.featurehub.io⁠

⁠Quick start (evaluation)

docker run -p 8085:8085 --user 999:999 -v $HOME/party:/db featurehub/party-server-ish:latest

Open http://localhost:8085⁠. This uses an embedded H2 database written to /db, which is for evaluation only. For a Postgres example, see docker-compose-options/party-server-ish-postgres in featurehub-install⁠. For a worked example, see Deploying on Google Cloud Run⁠.

⁠Ports

PortPurpose
8085Admin web app, MR API and Edge REST API (server.port)
8701Prometheus metrics and health checks (monitor.port)

⁠Configuration

You can set any configuration property as an environment variable with the same name and case. You can also mount /etc/app-config/application.properties and /etc/app-config/secrets.properties. See Run configuration⁠.

Party Server-ish accepts every property supported by the Management Repository⁠ and Edge (REST only)⁠ (Party-Server-ish config⁠).

Commonly used properties:

PropertyDescription
db.url, db.username, db.passwordJDBC connection to your database (defaults to H2 at /db). See Database configuration⁠.
db-replica.*Optional read replica. Edge requests go to it by default. See Database Read Replicas⁠.
webhooks.encryption.passwordKey for encrypting Slack tokens and webhook secrets. See Encryption⁠.
edge.cache-control.headerOverride the Cache-Control header on Edge GET responses. See Edge (all) Config⁠.
featurehub.url-pathServe FeatureHub under a context path other than /.
monitor.portPort for metrics and health checks. Set to 0 to serve them on the main port (useful on Cloud Run or ECS).

You can configure authentication through OAuth2 or SAML. See Identity⁠.

⁠Health and metrics

⁠More information

License: Apache 2 with Commons Clause.

Tag summary

Content type

Image

Digest

sha256:db1c59f93…

Size

209.9 MB

Last updated

4 months ago

docker pull featurehub/party-server-ish