Help Instance Help

Transity Deployment and Operations

Transity supports local container-based development and an automated production delivery path. The current deployable artifact is the backend service.

Local deployment

Docker Compose

From the Transity repository root:

docker compose up --build

Service

Address

Notes

Backend

http://localhost:8000

Application API and company UI

The backend uses the Swiss company database by default. Select another supported country with M8TY_COUNTRY; each country has an isolated database with the same public data model.

Production deployment

The current production path deploys the backend only.

  1. The delivery pipeline derives a release version from Git tags.

  2. Automated tests validate the backend.

  3. A production container image is built and published with release and commit identifiers.

  4. The deployment is upgraded in the target environment.

  5. The service is published at https://transity.m8ty.eu using Transport Layer Security (TLS).

The production image runs as an unprivileged user and includes the Swiss company database. Company synchronization and logo acquisition run outside the request-serving workload. Verified logos are served through the configured content delivery network (CDN).

Runtime configuration

Application settings use the M8TY_ prefix.

Variable

Default or deployed value

Purpose

M8TY_COUNTRY

ch

Select the country database

M8TY_LOG_LEVEL

INFO

Application log level

M8TY_LOGO_CDN_URL

Deployment-specific

Public base URL for verified logos

M8TY_RATE_LIMIT_ENABLED

true

Enable request limiting

M8TY_PROXY_TRUSTED_IP_HEADER

Deployment-specific

Read the client IP supplied by the trusted edge proxy

Operational checks

After deployment, verify the public service:

curl --fail 'https://transity.m8ty.eu/health' curl --fail 'https://transity.m8ty.eu/ready' curl --fail --get 'https://transity.m8ty.eu/api/companies/search' \ --data-urlencode 'q=Migros' \ --data-urlencode 'limit=1'

The first two commands must return an HTTP success response. The search request additionally proves that the deployed application can open and query its bundled company database.

See Also

23 August 2026