Skip to content

Repository files navigation

ruby-tak Main GitHub version Gem Version

RubyTAK—TAK server written in Ruby

Quick start

git clone https://github.com/pusewicz/ruby-tak.git
cd ruby-tak
./bin/setup
./exe/ruby_tak certificate ca
./exe/ruby_tak certificate server
./exe/ruby_tak server

See "Trusting the certificate" below to connect a TAK client to the server.

Trusting the certificate

RubyTAK signs its own certificates — there's no public CA — so each client needs to be told to trust ruby_tak-ca.crt (from ~/.config/ruby_tak/certs/) before it will connect:

  • macOS (including a "Designed for iPad/iPhone" TAK app running natively on Apple Silicon): open the .crt file in Keychain Access to import it, then double-click the imported certificate and set "When using this certificate" to Always Trust.
  • iOS/iPadOS: AirDrop or email ruby_tak-ca.crt to the device, open it to install it as a configuration profile (Settings → General → VPN & Device Management), then enable full trust for it under Settings → General → About → Certificate Trust Settings.

If the host's IP address changes (e.g. a new DHCP lease on a Raspberry Pi), the server certificate no longer covers it and certificate server won't regenerate it automatically — delete ruby_tak-server.crt and ruby_tak-server.key and re-run ./exe/ruby_tak certificate server.

Connecting from iTAK

Add RubyTAK in iTAK as a TAK Server:

  • Server address: the host's IP or hostname
  • Port: 8089
  • Username / Password: rubytak / password

Development

./bin/setup
./bin/rake

./bin/rake runs the test suite, RuboCop, and RBS type checking (rbs validate, steep check, and a run of the test suite under rbs/test that verifies the signatures against real runtime behavior). The gem ships its own sig/ directory, but it isn't self-contained: ox and xdg have no upstream RBS signatures, so sig/ruby_tak/message.rbs and sig/ruby_tak/configuration.rbs reference types a consumer's rbs collection won't resolve on its own. Signatures for those two gems live in vendor/sig/ for local type checking but aren't shipped.

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages