The communications platform that puts data protection first.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Rocket.Chat/ee/packages/federation-matrix
Kevin Aleman 25271b2c35
chore: Adapt logs to object format (almost) (#38280)
2 weeks ago
..
docker-compose chore: federation-matrix integration tests (#37219) 3 months ago
src chore: Adapt logs to object format (almost) (#38280) 2 weeks ago
tests fix(federation): set room topic on creation of federated rooms (#38264) 2 weeks ago
.env.example chore: federation-matrix integration tests (#37219) 3 months ago
.eslintrc.json chore: Reformat package manifest files (#37639) 2 months ago
.gitignore test(federation): remove qase monkey patch (#37818) 2 months ago
CHANGELOG.md Release 8.0.0 3 weeks ago
README.md chore: federation-matrix integration tests (#37219) 3 months ago
docker-compose.test.yml chore(federation): unify Docker Compose RC containers (#38187) 3 weeks ago
jest.config.federation.ts chore: Remove debug flag from Jest configuration and adjust error han… (#38175) 3 weeks ago
jest.config.ts chore(federation-matrix): Review build configuration (#37858) 2 months ago
package.json chore: Remove debug flag from Jest configuration and adjust error han… (#38175) 3 weeks ago
tsconfig.build.json chore(federation-matrix): Review build configuration (#37858) 2 months ago
tsconfig.json chore(federation-matrix): Review build configuration (#37858) 2 months ago

README.md

Federation Matrix

Rocket.Chat's Matrix federation integration package for cross-platform communication.

Integration Tests

Setup

Before running integration tests, add the following entries to your /etc/hosts file:

127.0.0.1       element
127.0.0.1       hs1
127.0.0.1       rc1

How It Works

The integration test script builds Rocket.Chat locally, starts federation services (Rocket.Chat, Synapse, MongoDB), waits for all services to be ready, then runs end-to-end tests. The script automatically handles cleanup unless you specify otherwise.

Available Flags

  • No flags (default): Builds local code and runs tests
  • --image [IMAGE]: Uses a pre-built Docker image instead of building locally (defaults to rocketchat/rocket.chat:latest if no image specified)
  • --keep-running: Keeps containers running after tests complete for manual validation
  • --element: Includes Element web client in the test environment
  • --no-test: Starts containers and skips running tests (useful for manual testing or debugging)

Usage Examples

Basic local testing:

yarn test:integration

Test with pre-built image:

yarn test:integration --image

Test with specific pre-built image:

yarn test:integration --image rocketchat/rocket.chat:latest

Keep services running for manual inspection:

yarn test:integration --keep-running

Run with Element client:

yarn test:integration --element

Start containers only (skip tests):

yarn test:integration --no-test

Start containers with Element and keep them running (skip tests):

yarn test:integration --keep-running --element --no-test

Combine flags:

yarn test:integration --image rocketchat/rocket.chat:latest --keep-running --element

Service URLs (when using --keep-running or --no-test)