Skip to content
Tazmu
InstallTerms of ServicePrivacy Notice

HELP AND SUPPORT

Help

How the subscription works, what to do when a server locks, how to cancel, and how to reach us. Your server and your data stay with you. We only run the account service at accounts.tazmu.xyz.

  • Getting started
  • Your subscription
  • Payment problems and locking
  • Moving the seat
  • Cancelling and refunds
  • Exporting your data
  • Deleting your account
  • Self-host checklist
  • Contacting support

Getting started

  1. Start your 7-day free trial at accounts.tazmu.xyz/billing. Sign in with GitHub, Google, or your email address and the code we send you. Tazmu accounts have no password, and you don't need a card to start.
  2. Install the server by following Install the Tazmu server.
  3. Open the setup link the installer prints. It creates your account on the server and signs the server in to your subscription.
  4. Pair the Mac and iPhone apps. See the self-host checklist.

I did not get a sign-in code

  • Codes come from a tazmu.xyz address. Check your spam folder.
  • A code works for 10 minutes. Asking for a new one cancels the old one.
  • You can ask for 3 codes per 15 minutes. After that, wait.

Your subscription

  • One plan, €9 a month, with a 7-day free trial. You don't need a card to start the trial. Add one before the trial ends to keep Tazmu.
  • One subscription covers one server. Connect as many Mac and iPhone apps to that server as you like. A second server needs a second subscription.
  • Manage it, see invoices and update your card at accounts.tazmu.xyz/billing.

Activate a server

In the server's settings, open Settings, then License, and sign in with the email on your account. Settings then shows your plan and the date it renews or the trial ends. Over SSH, run this on the server instead:

cd ~/tazmu
docker compose exec omb node dist-server/tazmu.js license login

The first server you sign in takes the seat. The billing page shows which server holds it.

New servers have 7 days to sign in

A server that has never been signed in runs for 7 days. The app shows a banner with the days left. Restarting or updating the server does not reset the count. The countdown ends when the server first gets an answer from accounts.tazmu.xyz. If the 7 days pass first, the server locks until you sign it in. The iPhone app cannot sign a server in. Use the web or Mac app, or the command above.

When the trial ends

  • If you added a card, we charge €9 on the last day of the trial and every month after that. The server keeps running.
  • If you did not add a card, or you cancelled during the trial, you are not charged. The server locks when the trial ends. Your data stays on your server.

Each account gets one free trial. If you subscribe again later, your first paid month starts straight away.

Payment problems and locking

The server checks its licence with accounts.tazmu.xyz when it starts, every 6 hours after that, and when you press Check again. Two grace periods keep it running while you fix a problem.

A payment failed

Stripe emails you and tries the card again over the next few days. Your server keeps working for 7 days after the failed payment, and the app shows a banner with the days left. To fix it:

  1. Open accounts.tazmu.xyz/billing.
  2. Choose Manage subscription and invoices.
  3. Update your card. Stripe retries the payment.

When the payment goes through, the banner clears on the next check. Press Check again to skip the wait.

If the 7 days end before the payment goes through, the server locks and we cancel your subscription. Updating the card after that does not bring it back. Start a new subscription on the billing page, then press Check again on the server. Your data is untouched. You do not get a second free trial.

The server cannot reach us

If the server cannot reach accounts.tazmu.xyz, it keeps working for 30 days after its last successful check. The app shows a banner with the days left. After that it locks until a check succeeds. Common causes:

  • A firewall or proxy blocks outbound HTTPS from the server.
  • DNS on the server is broken.
  • The server's clock is far off, so TLS fails.
  • Our service is down. We email you if that lasts, and your server keeps working through it.

Test from the server:

curl -s https://accounts.tazmu.xyz/healthz
# {"ok":true,"service":"tazmu-control-plane"}

Fix the network, then press Check again.

The locked screen

A locked server shows Subscription required, with the buttons Manage subscription and Check again. If the server's own sign-in is the problem, it shows Sign in to Tazmu or Sign in again instead.

A locked server runs no bot turns, routines or channel replies. Your data, settings, sign-in, billing links, export, backup and updates still work. Locking never deletes anything.

To unlock, fix the cause, then press Check again.

The screen saysWhat to do
The trial or subscription endedSubscribe again at accounts.tazmu.xyz/billing.
The last payment failed and the grace is overStart a new subscription at the billing page.
In use on another serverMove the seat to this server.
The server could not reach the account service for 30 daysFix the connection, as above.
The 7-day sign-in period has endedSign the server in, in Settings, then License.
The server is not signed in, or its sign-in was reset or has expiredSign in again, in Settings, then License. This happens when the server was removed from the account, the account was deleted, or the server was off long enough for its credential to expire.

Still locked after Check again? Email [email protected] with the output of diagnostics. See contacting support.

Moving the seat

Moving to a new machine, or reinstalling? Sign the new server in under Settings, then License. If another server holds the seat, the new one locks and the page says In use on another server.

  1. Press Manage subscription. It opens the billing page.
  2. Move the seat to the new server there.
  3. On the new server, press Check again.

The old server loses the seat at once and locks on its next check. You can move the seat 3 times in 90 days. If you reach that limit, or you cannot get to the new server's settings, email [email protected] from your account's address with the name of the server that should get the seat.

Cancelling and refunds

You can cancel at any time. Sign in at accounts.tazmu.xyz/billing, choose Manage subscription and invoices, and cancel there. The Manage subscription button on your server opens the same page. You can also email [email protected] and we will cancel it for you.

  • Cancel during the free trial and you are not charged. Your server locks when the trial ends.
  • Cancel later and your plan stays active until the end of the month you have already paid for. After that the server locks and we do not charge you again.

We do not give refunds. Payments are not refunded for a partly used month, for a month you did not use, or when you cancel or delete your account. This does not affect a refund the law requires, for example if Tazmu does not work as described, or the right of withdrawal below.

If you are a consumer in the EU, you can withdraw from the contract within 14 days of starting your subscription, without giving a reason, by emailing [email protected] within that period. When you start your subscription, you ask us to begin providing Tazmu straight away, during those 14 days. If you then withdraw, you pay for the service you received up to the day you withdraw. The first 7 days are a free trial, so withdrawing during the trial costs nothing. If you withdraw after the first payment but within the 14 days, we refund the part of that payment that covers the days after you withdrew, within 14 days, to the payment method you used.

If we ever stop offering Tazmu, we will give subscribers at least 60 days' notice and refund any time paid for beyond the closure date. The full wording is in the Terms of Service.

Exporting your data

Your data lives on your server, not with us, and export works while the server is locked. We cannot export it for you because we never have a copy.

  • Export backup, in the sidebar menu, saves bot setup, conversation text and each bot's memory notes in one file. It leaves out files, images and connections.
  • Usage history exports from Settings, then Usage, then History, with Export CSV.
  • A full backup of the data volume includes everything, including engine logins and settings. See Install for the backup the updater takes and how to restore it.

Deleting your account

Sign in at accounts.tazmu.xyz/billing and use Delete account. Deleting your account:

  • cancels any live subscription at once, with no refund for the rest of the month, apart from the exceptions above
  • signs you out everywhere and removes every server and app from the account
  • locks your server straight away, because its sign-in stops working

It does not touch anything on your server. To remove that data too, delete the Tazmu data volume on the server. To keep the paid days, cancel first, wait for the period to end, then delete the account.

If you cannot sign in, email [email protected] from the address on the account. We send a code to that address to confirm the request and complete it within one month. Signing in later with the same address creates a new, empty account.

Self-host checklist

Work through these in order. The commands and options for the installer are on the install page.

Before you start

  • A Mac or Linux machine that stays on. Ubuntu 22.04 or 24.04 with 2 CPUs and 4 GB of RAM is plenty. A Mac mini at home works too.
  • Docker with Compose v2. docker compose version should print a version.
  • A way to reach the server over HTTPS. That is a domain you control with ports 80 and 443 open, a reverse proxy of your own that already has TLS, or only the machine itself.
  • Outbound HTTPS from the server to accounts.tazmu.xyz and registry.tazmu.xyz.
  • An account with at least one AI engine you will run on the server, such as a Claude or ChatGPT subscription, or an API key.
  • A Tazmu trial or subscription, and a server credential from the Servers section of the billing page.

Install

Follow Install the Tazmu server. Docker restarts the server on its own after a reboot. When the installer finishes, open the setup link it prints and sign in to Codex or Claude from there.

HTTPS and the firewall

The server listens on 127.0.0.1 only. Never publish that port or bind it to a public address. Anything that can reach it has full control, including the shell your bots use. Put HTTPS in front of it, either with the installer's Caddy and your domain, or with your own proxy. Your own proxy must forward the real Host header, set X-Forwarded-For and X-Forwarded-Proto, and not buffer the event stream. Open only what you need. That is usually SSH, plus ports 80 and 443 when the installer's Caddy serves HTTPS.

Check it from your laptop, with your own host name:

curl -s https://tazmu.example.com/api/health

If your browser says "forbidden" once the proxy is up, the proxy almost always ended TLS without sending X-Forwarded-Proto: https.

Pair your devices

Use a fresh code for each device. Codes work once and expire after five minutes.

  • First browser. The setup link the installer printed pairs it.
  • Mac. Get the app from tazmu.xyz. Run the command below and copy the link it prints. In the Mac app, open the Server menu and choose Add Server from Copied Pairing Link.
  • iPhone. In the browser, open Settings, then Remote access, then Pair a phone or another computer, and scan the QR code from the app's pairing screen. Or run the second command below and paste the whole link into the app.
cd ~/tazmu
docker compose exec omb node dist-server/tazmu.js pair --label "My MacBook"
cd ~/tazmu
docker compose exec omb node dist-server/tazmu.js pair --client

A pairing code made with --client gives chat, approvals and reading, without settings.

Neither app comes from an Apple store yet, so installing takes one extra step. The Mac app is not notarized by Apple. Drag it to Applications and open it. macOS refuses the first time. Open System Settings, then Privacy and Security, find the message about Tazmu near the bottom, and choose Open Anyway. You do this once. If macOS says the app is damaged instead, run xattr -dr com.apple.quarantine /Applications/Tazmu.app in Terminal and open it again. The iPhone download is unsigned, so install it with a sideloading app that signs it for your phone, such as AltStore, SideStore or Feather.

Backups and updates

  • All state lives on the Docker data volume. Back it up and keep a copy off the server.
  • update.sh backs the volume up to ~/tazmu/backups before it updates. Copy those files somewhere else.
  • Update between routine runs. A turn that is running during the restart is lost. Queued work and routines survive.
  • If a new version misbehaves, roll back as described on the install page. Do not run an older version on data a newer one has used.
  • The Mac and iPhone apps check for updates on their own. Updates keep working while a server is locked.
  • Backups hold engine logins, provider keys and session tokens. Keep them private.

Contacting support

Email [email protected]. A person reads every message. For anything about billing, the seat or the account, write from the email address on your Tazmu account, so we know the account is yours. If your server is locked or shows a banner, read payment problems and locking first. Most of those take a minute to fix.

What to send

  1. What you expected and what happened instead, with the time and your time zone.
  2. How you installed Tazmu.
  3. A support bundle from the server. Attach the file instead of pasting it. It works with the server stopped too.
  4. A screenshot of Settings, then License, if the question is about the subscription or a locked server.
  5. For app problems, which app, its version, and the device.
cd ~/tazmu
docker compose exec omb node dist-server/tazmu.js diagnostics > tazmu-support.txt

The bundle has the version and commit, the OS, CPU, memory and disk figures, each engine's state, the update state, and up to 200 recent server log lines. It leaves out prompts, messages, transcripts, config values, environment variables, tokens and account emails. Log lines are cut short and have secrets, emails, home folder paths and URL query strings removed. Read it before you send it anyway.

What we never ask for

We will never ask you for any of these, by email or any other way. If someone claiming to be Tazmu asks, do not send it, and tell us.

  • Passwords. Tazmu accounts do not have one.
  • Sign-in codes from our emails.
  • Pairing codes or pairing links.
  • API keys or provider keys, such as Anthropic, OpenAI or xAI keys.
  • Engine logins, or files from ~/.claude, ~/.codex or similar.
  • Your server's credential, session tokens, or any .env file.
  • Backup archives, or the data folder.
  • SSH access to your server, or a remote session on your computer.
  • Your chats, bot output or files.

If you send one by mistake, tell us. We delete the message, and you should rotate the secret by signing the device out or creating a new API key at the provider.

What we can and cannot do

We can see your account email, your subscription state, which servers and apps are signed in to your account, and which server holds the seat. We can move the seat, sign a server out, sign you out everywhere, cancel the subscription, and delete the account. We cannot see anything on your server, recover data from it, or log in to it.

Response targets

These are targets, not a contract. We work Monday to Friday, Sofia time.

What is wrongFirst replyUpdates
Your server is locked and you think it should not be4 working hoursEvery working day until fixed
Tazmu is down or broken for you, with no workaround1 working dayEvery working day until fixed
Billing, account or seat question1 working dayAs needed
How-to question, or a bug with a workaround2 working daysAs needed
Feature request5 working daysNone

If our own service is down, we email the customers it affects and keep them updated until it is fixed.

Tazmu homeInstallPrivacy NoticeTerms of ServiceBuilt by K3S Studio