My `docker-compose.yml` config / How to run bbctl in Docker compose

[devnoname120]

Example of docker-compose.yml file with all supported services (except imessage):

x-bbctl-template: &bbctl
  image: ghcr.io/beeper/bridge-manager:latest
  restart: unless-stopped
  entrypoint: ['/usr/local/bin/bbctl', 'run', '--no-override-config']
  volumes:
    - ./data:/data
  environment:
    MATRIX_ACCESS_TOKEN: ${MATRIX_ACCESS_TOKEN}
    BBCTL_CONFIG: /data/bbctl.json
    BEEPER_ENV: prod
    DATA_DIR: /data
    DB_DIR: /data/db
  env_file: .env
  labels:
    com.centurylinklabs.watchtower.scope: beeper

services:
  rcs:
    <<: *bbctl
    command: sh-mautrix-rcs
  whatsapp:
    <<: *bbctl
    command: sh-mautrix-whatsapp
  signal:
    <<: *bbctl
    command: sh-mautrix-signal
  telegram:
    <<: *bbctl
    command: sh-mautrix-telegram
  facebook:
    <<: *bbctl
    command: sh-mautrix-facebook
  instagram:
    <<: *bbctl
    command: sh-mautrix-instagram
  linkedin:
    <<: *bbctl
    command: sh-mautrix-linkedin
  twitter:
    <<: *bbctl
    command: sh-mautrix-twitter
  discord:
    <<: *bbctl
    command: sh-mautrix-discord
  slack:
    <<: *bbctl
    command: sh-mautrix-slack

If you want to have auto-updates you can add this additional service at the bottom:

  watchtower:
    image: ghcr.io/containrrr/watchtower:latest
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      WATCHTOWER_SCOPE: beeper
      WATCHTOWER_CLEANUP: 1
      WATCHTOWER_INCLUDE_RESTARTING: 1
    labels:
      com.centurylinklabs.watchtower.scope: beeper

Then in the same directory create a .env file and put your Matrix token inside:

MATRIX_ACCESS_TOKEN=syt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

You can then start the containers:

docker compose up --detach --remove-orphans

Note: If you need to manually run a bbctl command you can always do something like this (here it's for logging in Beeper):

docker run --rm -it -v ./data:/data --env-file .env -e "BBCTL_CONFIG=/data/bbctl.json" -e "BEEPER_ENV=prod" -e "DATA_DIR=/data" -e "DB_DIR=/data/db" --entrypoint bbctl ghcr.io/beeper/bridge-manager:latest login

or

docker run --rm -it -v ./data:/data --env-file .env -e "BBCTL_CONFIG=/data/bbctl.json" -e "BEEPER_ENV=prod" -e "DATA_DIR=/data" -e "DB_DIR=/data/db" --entrypoint bbctl ghcr.io/beeper/bridge-manager:latest login-password

[phaphaya]

Hi @devnoname120 ,

thanks so much for this! However, I'm trying to run this on a Synology NAS, using Container Manager, and I have a problem that all the containers keeps stopping almost immediately after starting.

Containers of the inividual bridges stop as well with logs containing "You're not logged in" despite providing MATRIX_ACCESS_TOKEN in the .env file.

Have you encountered this problem? Can you give me a hand please?

[youshoes]

Hi @devnoname120 ,

thanks so much for this! However, I'm trying to run this on a Synology NAS, using Container Manager, and I have a problem that all the containers keeps stopping almost immediately after starting.

Containers of the inividual bridges stop as well with logs containing "You're not logged in" despite providing MATRIX_ACCESS_TOKEN in the .env file.

Have you encountered this problem? Can you give me a hand please?

In the last command, I changed it to login instead of login-password

docker run --rm -it -v ./data:/data --env-file .env -e "BBCTL_CONFIG=/data/bbctl.json" -e "BEEPER_ENV=prod" -e "DATA_DIR=/data" -e "DB_DIR=/data/db" --entrypoint bbctl ghcr.io/beeper/bridge-manager:latest login

[devnoname120]

@phaphaya Did you run the login-password command at the bottom? If you don't have a password use login instead as hinted by @youshoes

I don't have experience with Synology (and I don't like them because they sell staggeringly overpriced NAS devices with a crippled proprietary OS). So unfortunately I will not be able to help you further.

[cameronaaron]

Thank you so much

[iambenmitchell]

I ran the login command and then the compose file on my NAS.

Inspecting the logs I can see its successfully setup WhatsApp.

however, when trying to DM the bot on my iPhone or MacBook.. I am unable to find the convo

[iambenmitchell]

Maybe I am missing something.

Do I need to connect a domain, or do some type or port forwarding?

I am new to this all, in fact I only made my beeper account a couple hours ago.

[iambenmitchell]

Update:

You need to add them under settings - bridges by clicking "create bot room" on a desktop app as this does not show on iOS.

I also had to remove and re-add the bridges as the bridges section wasn't showing on the desktop app the first time for some reason