Configuration¶
Environment variables¶
Set in .env at the project root. Changing any of these requires a container restart.
| Variable | Default | Description |
|---|---|---|
JWT_SECRET |
auto-generated & persisted | Signs session tokens. Set it to pin your own value. |
ENCRYPTION_KEY |
auto-generated & persisted | Encrypts device passwords at rest. Set it to pin your own value. |
CORS_ORIGIN |
localhost defaults | Comma-separated browser origins allowed to call the API. Required in production. |
DB_PASSWORD |
mikrotik_secure_pw |
PostgreSQL password |
INFLUXDB_TOKEN |
mytoken123456789 |
InfluxDB admin token |
INFLUXDB_ORG |
mikrotik-manager |
InfluxDB organization |
INFLUXDB_BUCKET |
metrics |
InfluxDB bucket for time-series data |
INFLUXDB_ADMIN_PASSWORD |
admin_password_123 |
InfluxDB admin UI password |
REDIS_PASSWORD |
none | Makes Redis require a password. Can be set or changed at any time |
PASSWORD_LOGIN |
true |
false makes sign-in SSO-only. See SSO-only sign-in |
HTTP_PORT |
80 |
Host port for HTTP (redirects to HTTPS, or serves the app with TLS_MODE=proxy) |
HTTPS_PORT |
443 |
Host port for HTTPS |
HTTPS_PROXY |
unset | Optional proxy URL passed to npm and apk while building source images |
ACME_DOMAIN |
unset | DNS name for a Let's Encrypt certificate. See Let's Encrypt |
ACME_EMAIL |
unset | Contact email for Let's Encrypt expiry notices |
ACME_SERVER |
Let's Encrypt | Another ACME directory URL, such as staging or a private CA |
BIND_ADDRESS |
every interface | Host address the web UI is published on. See Network exposure. |
NETFLOW_BIND_ADDRESS |
every interface | Host address the NetFlow collector (UDP 2055) is published on. |
TLS_MODE |
https |
proxy when your own reverse proxy terminates TLS. See Behind a reverse proxy. |
TRUSTED_PROXIES |
none | Your reverse proxy's address or range, so the client address it forwards is believed. |
Never commit
.env. It is already listed in.gitignore.
For a production deployment the only variable you genuinely must set is CORS_ORIGIN.
Both secrets generate themselves safely — see below.
For source builds behind a network proxy, set HTTPS_PROXY in .env (for example,
HTTPS_PROXY=http://proxy.example.com:3128) and build with docker compose build. It is
passed as Docker's proxy build argument in both cases accepted by npm and apk; it is not
set in the running containers. The prebuilt GHCR images do not need this setting.
Internal service passwords¶
DB_PASSWORD, INFLUXDB_TOKEN, INFLUXDB_ADMIN_PASSWORD and REDIS_PASSWORD protect the
databases. Their defaults are public, so set your own. Postgres, InfluxDB and Redis sit on a
network of their own that only the backend joins, with no route out, so nothing else can reach
them. The passwords are a second layer.
On a new install, set them in .env before the first docker compose up -d. Hex values
are the easiest, since they need no quoting anywhere:
openssl rand -hex 24
On an existing install, Postgres and InfluxDB keep the password they were first started
with: they read these variables only when their data volume is empty. Changing .env alone
then leaves the backend unable to log in. Change the password inside the database first, then
in .env:
- Postgres:
docker compose exec postgres psql -U mikrotik -d mikrotik_manager \
-c "ALTER USER mikrotik WITH PASSWORD 'new-password'"
Then set DB_PASSWORD=new-password in .env and run docker compose up -d.
- InfluxDB token: create a new all-access token, put it in
INFLUXDB_TOKEN, rundocker compose up -d, then delete the old token:
docker compose exec influxdb influx auth create --all-access --org mikrotik-manager
influx auth list shows the old token's ID, and influx auth delete --id <id> removes it.
- Redis stores no password, so
REDIS_PASSWORDcan be set or changed at any time; rundocker compose up -dafterwards.
Before 0.24.51 the database password was part of a connection URL, so a password containing
/, @ or : stopped the backend from starting. It is now passed on its own.
First login¶
A new install has one account, admin with the password admin. Signing in with it goes straight to a page that asks for a new password (at least 10 characters and at most 72 bytes, with a letter and a number); nothing else works until it is set. The 72-byte limit is bcrypt's: it ignores anything longer, so a longer password changed only at the end would still accept the old one. The login page shows the default credentials only until then. An existing install still using admin/admin gets the same prompt at its next login.
Time display¶
Times show in 24-hour format unless you choose otherwise, in Settings → General → Time format.
- System default, for fleet admins: 24-hour (the default), 12-hour (AM/PM), or Browser default, which follows each browser's language settings.
- My time format, for every account, including site-scoped and SSO-only ones: follow the system default, or pick one of the three for yourself. It's saved to your account, so it follows you to other browsers, and changing the system default doesn't override it.
Dates follow the browser's language too, for example Nov 1, 14:30 in US English and
1. Nov., 14:30 in German.
This only changes how times are shown. Schedules still run in the timezone set under Settings → General, the API's times are unchanged, and the browser's own date and time pickers keep their regional format.
Appearance¶
Settings → General → Appearance sets how the manager looks to you, from @kraken-XIV's proposal in #329. It's kept in this browser, so each person, and each browser, can have their own.
- Theme: Light, Dark, or System, which follows your computer's light or dark setting and changes with it. The moon and sun in the top bar switch between light and dark.
- Accent colour: blue (the default), indigo, violet, emerald, teal, amber, rose, or your own colour from the rainbow swatch. Buttons, links, tabs, selections and highlights take it. Where a colour is too light to carry white text, the manager uses a darker shade of it, so buttons stay readable. Chart series, map pins and status colours (green, amber, red) don't change.
- Dark surfaces: Slate, as before, or Midnight, near-black for dark rooms and OLED screens.
- Faceplate ports: Ports (the default) draws each port on a device's Ports tab as the hardware looks: RJ45 jacks, SFP cages, QSFP28 and QSFP-DD cages, and broken-out cages as their lanes inside one cage outline. Up ports take the accent colour, with a green link light. Tiles brings back the plain green and red squares.
- Traffic graphs: Volume (the default) plots what each point of a traffic chart adds up, in bytes and packets: 4.2 GB at 19:45 is the traffic of the 15 minutes up to 19:45 on a 24-hour chart. Rate plots the same traffic per second, the way links are rated: bits per second (Kbps, Mbps, Gbps) and packets per second (Kpps). This applies to the Traffic page and a client's usage and app traffic charts. The newest point, still filling up, is divided by the time it has covered so far, so it doesn't dip. The totals stay in bytes. Interface graphs were already per second.
Sessions¶
A sign-in lasts up to 24 hours, but every request checks the account as it is now, so a session ends straight away when:
- the user logs out (that session only);
- an admin changes the user's role or resets their password (all of that user's sessions, in every browser);
- the user changes their own password (all their other sessions; the browser they changed it in stays signed in);
- the account is deleted.
The role in effect is always the account's current one. Open live-update and terminal connections are checked again every minute and closed when their session has ended, and a terminal re-checks the account before it opens a shell. Before 0.24.46 a session kept its original role and access for its full 24 hours, whatever happened to the account.
An admin who resets their own password from Settings → Users & Roles is signed out and signs in again with the new one. API tokens are separate and unaffected: revoke those under Settings → Automation → API Tokens.
Secret management (self-healing)¶
JWT_SECRET and ENCRYPTION_KEY are managed automatically so that a fresh install is
secure by default and an upgrade never strands existing data.
- Set to a strong value in the environment — that value is used, and you stay in control.
- Unset, or left at a value from an example file (for
JWT_SECRET, anything startingchangeme) — the backend generates a strong secret once, persists it to theapp_datavolume (SECRETS_DIR, default/app/data), and reuses it on every boot.
Secrets live outside the database deliberately: a database dump alone cannot reveal the key protecting the credentials stored inside it.
Upgrading is non-breaking¶
Existing ciphertext is decrypted through a legacy-key fallback — including previous shipped defaults — and transparently re-encrypted under the current key by a background sweep. Nothing needs to be re-entered.
Rotating the JWT secret off a public default invalidates sessions signed with it. Users simply log in again once.
Changing JWT_SECRET¶
Setting JWT_SECRET in .env (or changing it) is treated as a rotation. The secret the
manager was using before, and any older ones, keep working for 24 hours from the first start
with the new value, so signed-in users aren't cut off mid-session, and then stop. They are also
removed from secrets.json, so unsetting JWT_SECRET later never brings a retired secret back
(the manager generates a fresh one instead). This is the step to take if secrets.json may
have leaked; before 0.24.50 the leaked secret stayed valid. If the old secret must stop
working at once rather than after 24 hours, also delete the retiringJwtSecrets entry from
secrets.json in the app_data volume and restart the backend; everyone then signs in again.
Key rotation¶
Settings → General → Encryption key shows where the key comes from, a short key ID (a fingerprint, not the key), and how many stored values are under the current key, under an older key, or under no key the manager has.
Everything the key protects is covered: device API and SSH passwords, credential presets, SSH private keys, the SSO client secret, alert channel secrets (SMTP password, Telegram bot token, ntfy and Gotify tokens, Slack and Discord webhook URLs), webhook signing secrets, and backups that contain secrets. On every start, anything still under an older key is re-encrypted with the current one.
A key the manager generated (the default, kept in app_data/secrets.json):
- Click Rotate key… and confirm. A new key is written to
secrets.jsonwith the old one kept beside it, and only then does the manager switch. Everything is re-encrypted straight away. - When the card shows nothing under an older key, click Retire older keys.
A key you set in .env:
- Put the new key in
ENCRYPTION_KEYand the old one inENCRYPTION_KEY_PREVIOUS, then restart (docker compose up -d). The manager re-encrypts everything with the new key as it starts. - When the card shows nothing under an older key, remove
ENCRYPTION_KEY_PREVIOUSand restart again.
ENCRYPTION_KEY_PREVIOUS takes a comma-separated list if you have more than one old key.
Changing ENCRYPTION_KEY without ENCRYPTION_KEY_PREVIOUS
Before 0.24.46 this silently made every stored credential unreadable. Now the manager
notices at startup: it shows Encryption key missing to admins, logs it, and refuses to
save new credentials, so nothing is written under the wrong key. Put the original key back
(in ENCRYPTION_KEY, or in ENCRYPTION_KEY_PREVIOUS) and restart, and everything reads
again. Don't re-enter device passwords first.
The same happens if the key is lost with the app_data volume, for example after moving the
manager to a new host with only a database dump: restore secrets.json and restart.
Backing up the manager¶
Settings → Backup & Restore makes encrypted backups of the manager, on a schedule if you like, and copies them to S3, SFTP or email. It also restores them, including onto a new server. See Backing up MikroTik Manager, which also lists what to keep if you'd rather back up by hand.
Settings stored in the database¶
These are edited in the Settings UI and take effect without a restart:
| Area | Settings | Documented in |
|---|---|---|
| Change Guard | change_guard_enabled, change_guard_mode, change_guard_timeout_sec |
Change Guard |
| Config Health | config_health_enabled, config_health_interval_min |
Change Guard |
| Polling | fast / slow / log intervals, MAC scan, spectral and AP scan cadence | Settings → Polling |
| Config snapshots | config_snapshot_enabled, config_snapshot_interval_min, config_snapshot_retention |
Settings → General |
| NetFlow | collector address and port, version, retention, top-N clients | Network Services → NetFlow |
| Alerting | rules, thresholds, cooldowns, channels | Alerting |
Who sees Settings¶
- Admins (fleet-wide) see and change everything.
- Operators (fleet-wide) see every setting, read-only, apart from the SSH Keys tool. This includes alerting, webhooks and report schedules, which operators could change before 1.1. Secrets stay masked.
- Viewers, and any account limited to particular sites, see only their own account: time format and password.
Network exposure¶
The manager holds the admin credentials for every device it manages, so keep it off the internet: reach it over your LAN or a VPN.
By default Docker publishes the web UI (80, 443) and the NetFlow collector (UDP 2055) on every host interface. A host firewall such as ufw or firewalld does not close them: Docker adds its own rules for published ports, and traffic to them never reaches the chains those tools manage. On a host with a public or DMZ interface, the manager is reachable from the internet even though ufw says the port is closed.
Pick one of these:
- Publish on one address. Set
BIND_ADDRESS(andNETFLOW_BIND_ADDRESS) in.envto the host's LAN or VPN address, thendocker compose up -d:
BIND_ADDRESS=192.168.1.10
NETFLOW_BIND_ADDRESS=192.168.1.10
Only that address listens. To reach it over IPv6 as well, leave it unset and use the next option instead.
- Filter in the
DOCKER-USERchain. Docker checks this chain before its own rules, so it does apply to published ports. For example, to allow the UI only from 192.168.1.0/24 and NetFlow only from your routers' management subnet, whereeth0is the public interface:
iptables -I DOCKER-USER -i eth0 -p tcp -m conntrack --ctorigdstport 443 ! -s 192.168.1.0/24 -j DROP
iptables -I DOCKER-USER -i eth0 -p tcp -m conntrack --ctorigdstport 80 ! -s 192.168.1.0/24 -j DROP
iptables -I DOCKER-USER -i eth0 -p udp -m conntrack --ctorigdstport 2055 ! -s 10.10.0.0/24 -j DROP
These rules don't survive a reboot by themselves; save them the way your distribution
does (for example netfilter-persistent save).
- Put the host behind a firewall it doesn't control, such as the router in front of it or a cloud security group.
NetFlow has no authentication of its own, so whatever can reach UDP 2055 can send flows. The collector only accepts flows from managed devices unless you turn on Accept flows from unknown exporters (see Traffic), but limiting who can reach the port is still the real protection.
Before 0.24.47 there was no bind setting, and the ports were always published on every interface.
Container hardening¶
From 0.24.51 the containers run with less:
- backend: every Linux capability dropped except
NET_RAW(server-side ARP discovery), a read-only root filesystem, and a non-root user that owns only its data directories. It can write its volumes and/tmp, and nothing else. - nginx: only the capabilities it uses, and a read-only root filesystem.
- Postgres, Redis, InfluxDB: on the internal network only.
- Logs from every container rotate at 10 MB, five files each.
The containers don't set no-new-privileges. On Ubuntu with AppArmor it stops them starting at
all: the first command in the container fails with "operation not permitted". 0.24.51 set it,
and on such hosts the update left the databases restarting; 0.24.52 removes it.
TLS¶
A self-signed certificate is generated on first run. Replace it under Settings → Certificate by uploading a certificate and private key, or regenerate the self-signed one; nginx terminates TLS, picks up the new certificate within a few seconds, and redirects HTTP to HTTPS.
Before 0.24.37 both failed with "permission denied": the certificate volume was owned by root and the backend runs as a normal user. The nginx container now hands the volume to the backend user (uid 100, gid 101) at every start, which also fixes existing installs.
Let's Encrypt (ACME)¶
With a public DNS name, the manager can get and renew its own certificate from Let's Encrypt
(#420, contributed by eskyuu). Point the name at the host, make sure port 80 is reachable from the
internet, keep TLS_MODE=https, and enter the name under Settings → Certificate → Automatic HTTPS
Certificate (ACME). The email is optional, but without one you get no expiry notices.
- It starts within a few seconds of saving, with no restart. The certificate replaces the one in use, including an uploaded one, and nginx reloads.
- Renewal is checked every 12 hours. A failed request is retried after an hour, and the certificate in use stays until a new one arrives.
- Last Certbot Attempt on the same card shows the result and Certbot's output, which is the
place to look when it fails.
docker compose logs nginxhas it too. - To turn it off, press Use .env Values with no
ACME_DOMAINin.env. The certificate it got stays in place. - It can't work with
TLS_MODE=proxy; there, use your proxy's own certificates.
The same settings can come from .env: ACME_DOMAIN, ACME_EMAIL and ACME_SERVER (blank means
Let's Encrypt). Settings saved in the page win over .env, and Use .env Values drops them.
When all three are set in .env, they win and the page is read-only.
Staging or a private ACME server. Set its directory URL. If its own HTTPS certificate comes from a private CA, paste that CA under ACME Server CA Bundle. The bundle replaces Certbot's usual trust store, so include every CA the server needs; removing it goes back to the usual one. Certificate checks stay on either way.
Behind a reverse proxy¶
If you already run a reverse proxy (Nginx Proxy Manager, Traefik, Caddy, HAProxy) that holds
your certificates, let it terminate TLS and hand plain HTTP to the manager (#256). Set in
.env:
TLS_MODE=proxy
TRUSTED_PROXIES=10.0.0.5
CORS_ORIGIN=https://mtm.example.com
Then docker compose up -d.
| Variable | Default | What it does |
|---|---|---|
TLS_MODE |
https |
proxy serves the app over plain HTTP on HTTP_PORT instead of redirecting it to HTTPS. HTTPS on HTTPS_PORT keeps working with the manager's own certificate. |
TRUSTED_PROXIES |
none | Your proxy's address or range (CIDR), comma-separated, IPv4 or IPv6. Only requests from these addresses may say who the client is (X-Forwarded-For) and that the browser used HTTPS (X-Forwarded-Proto). |
CORS_ORIGIN |
The address people type in the browser, as the proxy serves it. The browser sends it with every request, and the API refuses origins not on the list. |
Point the proxy at http://<manager host>:<HTTP_PORT>, and turn on WebSocket support: live
updates and the device terminal run over /socket.io/.
Give the proxy a read timeout of at least 300 seconds (the same as the manager's own). Many proxies default to 60, and a protected change on a slow device can take longer: on a CRS112 a bridge move took about a minute and a half end to end.
Some proxies can't wait that long. Cloudflare gives up after 100 seconds and shows its own 502 page. Switching a device to API-SSL or WebFig to HTTPS can take several minutes while an older router signs a certificate, so from 1.0.14 these switches carry on in the background when they take longer than about 25 seconds, and the page fetches the outcome when it's ready. Other long requests, such as a protected change on a slow device or a large backup, still need the proxy to wait; behind Cloudflare, make those from an address that reaches the manager directly.
Keep the plain HTTP port for the proxy only. Anyone else who can reach it talks to the
manager unencrypted. If the proxy runs on the same host, BIND_ADDRESS=127.0.0.1 keeps both
ports off the network; otherwise use one of the options in
Network exposure.
Why TRUSTED_PROXIES matters. Without it every request appears to come from the proxy:
the audit log shows the proxy's address, and the per-address limit on sign-in attempts counts
all your users as one, so a busy morning or a few typos can stop everyone signing in for a
while. Headers from anyone
else are ignored, so a client can't claim to be somewhere else by sending its own
X-Forwarded-For. The nginx container logs a warning at start if TLS_MODE=proxy is set
without it.
Not sure which address the proxy arrives from? Leave TRUSTED_PROXIES unset, sign in once
through the proxy, and look at the IP column of the newest entry under Settings →
Audit Log. A proxy on the same host usually arrives from the Docker network's gateway
(such as 172.18.0.1), not 127.0.0.1.
A proxy in Docker can join the manager's network instead of going through a published
port. Its upstream is then http://nginx:80, and TRUSTED_PROXIES is the proxy container's
address, or the network's range such as 172.18.0.0/16.
SSO builds its redirect address from the host and scheme the proxy forwards, so it works
as long as TRUSTED_PROXIES is right. If your provider still rejects the callback, set
Public base URL in the SSO settings (see SSO).
Examples¶
Nginx Proxy Manager: a proxy host with scheme http, the manager's address and HTTP_PORT,
Websockets Support on, and your certificate on the SSL tab.
Caddy:
mtm.example.com {
reverse_proxy 10.0.0.20:80
}
Traefik, with the manager's nginx service on Traefik's network:
labels:
- traefik.enable=true
- traefik.http.routers.mtm.rule=Host(`mtm.example.com`)
- traefik.http.routers.mtm.entrypoints=websecure
- traefik.http.routers.mtm.tls=true
- traefik.http.services.mtm.loadbalancer.server.port=80
Caddy and Traefik send X-Forwarded-For and X-Forwarded-Proto and pass WebSockets through
by default.
HAProxy:
frontend https-in
bind :443 ssl crt /etc/haproxy/certs/mtm.pem
option forwardfor
http-request set-header X-Forwarded-Proto https
default_backend mtm
backend mtm
timeout server 300s
timeout tunnel 1h
server mtm 10.0.0.20:80
option forwardfor adds X-Forwarded-For. HAProxy passes WebSocket upgrades through by
itself; timeout tunnel keeps an open terminal from being cut after the server timeout.
NetScaler (Citrix ADC): a load-balancing virtual server of type SSL with your certificate, and
an HTTP service to the manager's HTTP_PORT. The pieces that matter here:
add ns httpProfile mtm_http -webSocket ENABLED
add service mtm_svc 10.0.0.20 HTTP 80 -cip ENABLED X-Forwarded-For -svrTimeout 300
add lb vserver mtm_vs SSL 203.0.113.10 443 -httpProfileName mtm_http -cltTimeout 300
bind lb vserver mtm_vs mtm_svc
bind ssl vserver mtm_vs -certkeyName mtm_cert
add rewrite action mtm_xfp insert_http_header X-Forwarded-Proto "\"https\""
add rewrite policy mtm_xfp_pol true mtm_xfp
bind lb vserver mtm_vs -policyName mtm_xfp_pol -priority 100 -type REQUEST
NetScaler connects to the manager from its subnet IP (SNIP), not the virtual server's address,
so that's the address for TRUSTED_PROXIES.
Updating and image versions¶
Images are published to GHCR only after CI has passed on that commit:
ghcr.io/2gt-media-group-llc/mikrotik-manager-backend and …-nginx. Each is tagged with
its version (for example 1.0.0) and sha-<commit>, and the newest build of each channel
also carries latest (stable) or beta (see Release channels). The
GHCR compose file uses MTM_TAG from .env, latest when it isn't set: set it to a version
tag to stay on that version, or to beta for the beta channel.
Update the compose file too, not only the images. docker compose pull fetches new images
but leaves your compose file as it was, and some releases add settings that only work if the
compose file passes them to the containers. A setting in .env that the compose file doesn't
mention never reaches the container, silently. For example, TLS_MODE and TRUSTED_PROXIES
(Behind a reverse proxy) need the compose file from 0.46.0 or later;
with an older one, the manager stays in HTTPS mode and a proxy in front of it loops on
redirects. So when updating:
- from a git checkout:
git pull, thendocker compose pull && docker compose up -d; - with only the GHCR compose file: download
docker-compose.ghcr.ymlagain (keep your.env), then pull and start as above.
To check that a setting arrived, ask the container: docker compose exec nginx printenv TLS_MODE.
The databases during an update¶
An update that changes the Postgres, Redis or InfluxDB image restarts that container, and the release notes say so when it does. Each gets 60 seconds to shut down cleanly before Docker stops it (Docker's own default is 10), so an update never cuts one off mid-write.
Redis holds only the manager's job queue, which refills itself. If its append-only file is
damaged (for example, the disk lost a write in a power cut or a hard reset), Redis refuses to
start, and the rest of the stack waits for it. So before Redis starts, the file is checked, and
if it's damaged it's repaired with Redis's own redis-check-aof --fix, which cuts it at the last
good record. At most, jobs queued after that point are lost, and they're queued again. Redis's
log says when this happens:
[mtm] Redis's append-only file was damaged. It was repaired by cutting it at the last good record; ...
A copy of the damaged files is kept in the Redis volume as appendonlydir.damaged-<time>, the
newest two. Once all is well you can remove them:
docker compose exec redis sh -c 'rm -rf /data/appendonlydir.damaged-*'.
Release channels¶
From 1.0 there are two lines, and you choose which one you follow:
| Channel | Git branch | Image tag | What it gets |
|---|---|---|---|
| Stable (default) | main |
:latest |
1.0.x: fixes only, including security fixes |
| Beta | dev |
:beta |
The next minor version as betas (1.1.0-beta.1, ...), with new features as they land, then its release candidates (1.1.0-rc.1, ...) |
Stable is what you get unless you change something, and what production fleets should run.
New features are built on dev and reach stable in the next minor release; fixes go to both.
To follow the beta channel:
- from a git checkout:
git checkout dev, then update as above (git pull, thendocker compose pull && docker compose up -d); - with the GHCR compose file: add
MTM_TAG=betato your.env, then pull and start as above.
To go back to stable, git checkout main (or remove MTM_TAG) and update. Going back only works
once stable has caught up with the version you were on, because the database is migrated
forwards, not back; until then, stay on beta or restore a platform backup taken on stable.
The update notice in the app follows your channel: a stable install is told about stable
releases, a beta or release candidate install about the next one on dev. A specific version
can be pinned with its image tag (MTM_TAG=1.0.0, or MTM_TAG=1.1.0-rc.1).
From 0.24.51 each image carries an SBOM and build provenance, and is signed with cosign by the workflow that built it. To check an image before running it:
cosign verify ghcr.io/2gt-media-group-llc/mikrotik-manager-backend:latest \
--certificate-identity-regexp 'https://github.com/2GT-Media-Group-LLC/mikrotik-manager/' \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
Base images and the database images are pinned by digest, so a tag moved upstream can't change what's built or run until an update is reviewed.
Dark Site Mode¶
Settings → Dark Site Mode lists every feature that makes a request to the internet on its own, with where each one goes and what stops working without it. Each can be turned off individually. All are on by default.
| Feature | Destination | When off |
|---|---|---|
| Maps and address lookup | *.tile.openstreetmap.org, nominatim.openstreetmap.org |
No location maps; addresses are kept as text |
| Platform update check | raw.githubusercontent.com |
The dashboard does not report newer releases |
| Daily RouterOS update check | MikroTik's update servers, contacted by each device | Devices are not asked daily; the on-demand button still works |
| RouterOS changelogs | download.mikrotik.com |
Release notes are not shown |
| MAC vendor database download | standards-oui.ieee.org |
The vendor list is not refreshed; an existing copy is still used |
| IP owner database download | iptoasn.com |
Traffic destinations are named from the copy built into the release, which ages until the next update |
| RouterOS vulnerability list | services.nvd.nist.gov, www.cisa.gov |
The Security page doesn't list known CVEs for the fleet's versions |
| Documentation link | 2gt-media-group-llc.github.io |
The top-bar documentation button is hidden |
Alert channels (Slack, Discord, Telegram, ntfy, webhooks) and AdGuard Home sources are not listed. They send only when a destination has been configured, so leaving them unconfigured is already the off switch.
The daily RouterOS check is the one that is easy to miss when auditing a firewall: the request comes from each MikroTik device, not from the manager's host.
The MAC vendor database is downloaded at startup when the cached copy is older than its refresh interval. With the download off, the cached copy is used however old it is. Before v0.24.24 a failed download discarded the cache and left vendor lookups empty; it now falls back to it.