Status	Maintained
Stable Version
CI/CD

any-sync-bundle is a prepackaged, all-in-one self-hosted server solution designed for Anytype, a local-first, peer-to-peer note-taking and knowledge management application. It is based on the original modules used in the official Anytype server but merges them into a single binary for simplified deployment and zero-configuration setup.

This is a zero-config version of the official Anytype server. It uses the same upstream modules Anytype ships, but compacts them into a single binary - think of it as "K3s for Any Sync".

Replace the external address (e.g., 192.168.100.9) with an address or hostname clients should connect to. This is test start, check below more real configuration.

docker run \
    -e ANY_SYNC_BUNDLE_INIT_EXTERNAL_ADDRS="192.168.100.9" \
    -p 33010:33010 \
    -p 33020:33020/udp \
    -v $(pwd)/data:/data \
  ghcr.io/grishy/any-sync-bundle:1.1.1-2025-10-16

After the first run, point Anytype desktop/mobile apps at the generated client config in ./data/client-config.yml.

• Easy to start: A single command to launch the server
• All-in-one option: All services in a single container or in separate binaries
• Lightweight: No MinIO, and no duplicate logical services
• Only 2 open ports: TCP 33010 (DRPC protocol) and UDP 33020 (QUIC protocol), configurable

• Self‑hosters and small teams who want a simpler, single‑binary Any Sync deployment.
• Homelab or small server setups where fewer moving parts and clear defaults matter.

What this is not:

• A high‑availability or horizontally scaled deployment. If you need HA, use upstream components directly and follow Anytype’s official guidance.

The project version combines the bundle version and the original Anytype version. Example: v1.1.1-2025-10-16

• v1.1.1 – The bundle's semver version
• 2025-10-16 – The Anytype any-sync compatibility version from anytype.io

Compatibility: 0.x (e.g., 0.5) is not supported. From 1.x onward we follow SemVer; 1.x upgrades are non‑breaking.

Pick one of the published tags, for example v1.1.1-2025-10-16 (see Packages).

Latest tags are also available (ghcr.io/grishy/any-sync-bundle:latest, :minimal), but using an explicit release tag keeps upgrades deliberate (my recommendation).

• ANY_SYNC_BUNDLE_INIT_EXTERNAL_ADDRS multiple addresses can be added, separated by commas.
• ANY_SYNC_BUNDLE_INIT_* variables seed the initial configuration on first start; their values are persisted to bundle-config.yml afterward.

1. Container (all-in-one with embedded MongoDB/Redis)

   docker run -d \
       -e ANY_SYNC_BUNDLE_INIT_EXTERNAL_ADDRS="192.168.100.9" \
       -p 33010:33010 \
       -p 33020:33020/udp \
       -v $(pwd)/data:/data \
       --restart unless-stopped \
       --name any-sync-bundle-aio \
     ghcr.io/grishy/any-sync-bundle:1.0.0-2025-09-08

2. Container (solo bundle, external MongoDB/Redis)

   docker run -d \
       -e ANY_SYNC_BUNDLE_INIT_EXTERNAL_ADDRS="192.168.100.9" \
       -e ANY_SYNC_BUNDLE_INIT_MONGO_URI="mongodb://user:pass@mongo:27017/" \
       -e ANY_SYNC_BUNDLE_INIT_REDIS_URI="redis://redis:6379/" \
       -p 33010:33010 \
       -p 33020:33020/udp \
       -v $(pwd)/data:/data \
       --restart unless-stopped \
       --name any-sync-bundle \
     ghcr.io/grishy/any-sync-bundle:1.0.0-2025-09-08-minimal

• All-in-one image only:

  docker compose -f compose.aio.yml up -d

• Bundle + external MongoDB + Redis:

  docker compose -f compose.external.yml up -d

• With Traefik reverse proxy (TCP 33010 + UDP 33020):

  docker compose -f compose.traefik.yml up -d

  Edit ANY_SYNC_BUNDLE_INIT_EXTERNAL_ADDRS in the compose file before starting.

1. Download the binary from the Release page

2. Start as below (replace IP and URIs as needed):

   ./any-sync-bundle start-bundle \
     --initial-external-addrs "192.168.100.9" \
     --initial-mongo-uri "mongodb://127.0.0.1:27017/" \
     --initial-redis-uri "redis://127.0.0.1:6379/" \
     --initial-storage ./data/storage

   systemd example:

   [Unit]
   Description=Any Sync Bundle
   After=network-online.target
   Wants=network-online.target
   
   [Service]
   WorkingDirectory=/opt/any-sync-bundle
   ExecStart=/opt/any-sync-bundle/any-sync-bundle start-bundle \
     --initial-external-addrs "example.local,192.168.100.9" \
     --initial-mongo-uri "mongodb://127.0.0.1:27017/?replicaSet=rs0" \
     --initial-redis-uri "redis://127.0.0.1:6379/" \
     --initial-storage /opt/any-sync-bundle/data/storage
   Restart=on-failure
   RestartSec=5
   
   [Install]
   WantedBy=multi-user.target

Prerequisites:

• Go 1.25.2 or later
• Docker (optional, for testing with containers)

Build:

go build -o any-sync-bundle .
./any-sync-bundle --version

Run tests:

go test -race -shuffle=on -vet=all ./...

Run linter:

golangci-lint run

Nix provides reproducible builds and a complete development environment with one command.

Prerequisites: Nix; direnv and hook it into your shell

Build the binary:

nix build
./result/bin/any-sync-bundle --version

Run directly:

nix run . -- --help

Development environment:

# Enter development shell with all tools (Go, golangci-lint, goreleaser, etc.)
nix develop

# Or use direnv for automatic environment activation
echo "use flake" > .envrc
direnv allow

Check flake:

nix flake check

There are two configuration files under ./data by default:

• bundle-config.yml — Private/important. Created on the first run. Contains service configuration and private keys. Back this up.
• client-config.yml — Regenerated on each start. Import this into Anytype apps to connect to your server.

After the first start, point Anytype desktop/mobile apps to ./data/client-config.yml.

Read more about it in the official docs:

• Anytype Docs -> Self-hosted
• Anytype Tech -> Self-hosting

All parameters are available in two ways: binary flags or container environment variables. See ./any-sync-bundle --help for details.

Important: "initial-_" options (for example --initial-external-addrs or ANY_SYNC_BUNDLE_INIT*) are used only on the first run to create bundle-config.yml. Subsequent starts read from the persisted bundle-config.yml.

• help — Show help for the binary.
• start-bundle — Start all services, using external MongoDB and Redis. Ensure MongoDB has a replica set initialized before starting.
• start-all-in-one — Used inside the official all‑in‑one container. Starts Redis and MongoDB inside the container and initializes the MongoDB replica set automatically.

Flags for start-bundle and start-all-in-one:

I explored a "light" Any Sync variant without MongoDB and Redis, using a single BadgerDB instance for all logical services (touching filenode, consensus, and coordinator). I decided not to continue due to long‑term maintenance cost. Currently, only the filenode is slightly modified to remove the MinIO dependency.

The light version exists as a draft PR and is not planned for active development.

⚠️ Always backup before upgrades

1. Stop your service
2. Backup the ./data/ directory
3. Restart service

Core backup command:

tar -czf backup-$(date +%Y%m%d-%H%M%S).tar.gz ./data/

1. Stop your service
2. Remove current data directory
3. Extract backup
4. Restart service

Core restore command:

rm -rf ./data && tar -xzf backup-YYYYMMDD-HHMMSS.tar.gz

If update fails to start:

1. Stop failed service
2. Remove data: rm -rf ./data
3. Restore backup: tar -xzf backup-YYYYMMDD-HHMMSS.tar.gz
4. Restart with previous version/image

• MongoDB replica set is not initiated (external DB):
  • Initialize manually once: mongosh --host <mongo:27017> --eval "rs.initiate({_id:'rs0', members:[{_id:0, host:'localhost:27017'}]})"
  • Replace localhost with the actual hostname or IP of your MongoDB server that will be used by the bundle later, if needed.
• Embedded MongoDB/Redis in AIO does not start:
  • Check logs for "starting embedded MongoDB/Redis". If the data directories are corrupted, stop the container and if you no need data, remove /data/mongo or /data/redis before restarting.
• QUIC/UDP blocked:
  • Open UDP 33020 on firewalls/NAT. Some environments block UDP by default.
  • Advertise both hostname and IP in ANY_SYNC_BUNDLE_INIT_EXTERNAL_ADDRS for clients behind NAT. Anytype will select one of the addresses to connect to that works.
• Wrong external address after first run:
  • Edit ./data/bundle-config.yml → externalAddr: list, then restart the server. The new client-config.yml will be regenerated.

Reminder for releasing a new version.

# 1. Check locally
goreleaser release --snapshot --clean

# 1. Set variables (fish-shell)
set VERSION v1.1.1
set ANYTYPE_UNIX_TIMESTAMP 1760632373

# 2. Format date
set ANYTYPE_FORMATTED (date -r $ANYTYPE_UNIX_TIMESTAMP +'%Y-%m-%d')
set FINAL_VERSION $VERSION-$ANYTYPE_FORMATTED

# 3. Create tag and push
git tag -a $FINAL_VERSION -m "Release $FINAL_VERSION"
git push origin tag $FINAL_VERSION

Because I stand on the shoulders of giants, I can see further than they can.

"Perfection is achieved, not when there is nothing more to add, but when there is nothing left to take away" – Antoine de Saint-Exupéry

© 2025 Sergei G. Licensed under MIT.