Petacomm Petacomm
Use Cases Support GitHub LinkedIn All Petacomm
petacomm.io › Setup

Get up and running
in minutes

Step-by-step setup guides for Petacomm Easy, GateBell and RouteChecker. Choose your tool and your Linux distribution — we'll walk you through the rest.

Quick Start Full Docs ›
New: Petacomm Easy v3.4 — now supports air-gapped installation and Ansible role. See what's new →
3 minEasy Setup Time
5 minGateBell Setup
18+Distros Supported
0Prerequisites

Choose your tool

Each tool has its own setup guide below. All tools can be installed independently or together.

Petacomm Easy
AI-powered Linux management via natural language. Uses Claude API.
AI-Powered
GateBell
SSH gateway monitoring with real-time alerts. <2ms latency.
New — v1.0
RouteChecker
Network route analysis and BGP path diagnostics.
Web App
Install everything in one command
bash — all tools, auto distro detection
$ curl -fsSL https://repo.kotechsoft.com/easy.sh | sudo bash

Installs Petacomm Easy and GateBell. After install, run sudo peta configure --api-key YOUR_KEY to activate AI features.

Petacomm Easy — Setup Guide

AI-powered Linux server management. From zero to running in under 3 minutes.

1
Prerequisite

Get a Claude API key

Petacomm Easy uses Anthropic's Claude API to process natural language commands. You need an API key before installation.

Get API Key at platform.claude.com
2
Petacomm Easy

Install the tool

Choose your installation method. The one-line installer is recommended for most systems.

bash
$ curl -fsSL https://repo.kotechsoft.com/easy.sh | sudo bash
bash — Debian / Ubuntu
$ curl -fsSL https://apt.petacomm.io/gpg | sudo gpg --dearmor \
-o /usr/share/keyrings/petacomm.gpg
$ echo "deb [signed-by=/usr/share/keyrings/petacomm.gpg] https://apt.petacomm.io stable main" \
| sudo tee /etc/apt/sources.list.d/petacomm.list
$ sudo apt update && sudo apt install -y petacomm-easy
bash — Arch Linux
$ yay -S petacomm-easy
bash — RHEL / Fedora
$ sudo rpm --import https://rpm.petacomm.io/gpg
$ sudo dnf install -y petacomm-easy
3
Petacomm Easy

Add your API key

Configure your Claude API key. It is stored encrypted in the Petacomm keyring.

bash
$ sudo peta configure --api-key sk-ant-xxxxxxxxxxxxxxxx
✓ API key saved to /etc/petacomm/keyring
4
Petacomm Easy

Start the service

bash
$ sudo peta start --enable-all
✓ petacomm-easy active
✓ Web UI available at http://localhost:7474
✓
Petacomm Easy

You're ready — try your first command

petacomm-easy — first run
user@server:~$ peta -r "show me the top 5 memory-hungry processes"

AI Running: ps aux --sort=-%mem | head -6
→ Execute? [y/N]: y

USER PID %MEM COMMAND
deploy 1204 8.2 /usr/bin/node server.js
root 1398 4.1 /usr/bin/postgres
www 1502 2.9 /usr/sbin/apache2
redis 1603 1.2 /usr/bin/redis-server
root 812 0.8 /usr/bin/python3

user@server:~$

What gets installed

The installer sets up the peta CLI, the petacomm-easy daemon, and a local Web UI on port 7474. No Docker or Node.js required.

Full documentation ›
Confirmation prompt: By default, Petacomm Easy shows the generated command and asks y/N before executing. To skip confirmations, add -y to your command — but use this with care.
Supported distributions
UbuntuDebian ArchAlpine RHELFedora +12 more

GateBell — Setup Guide

SSH gateway monitor and alerting. Ready in 5 minutes, no reboot required.

1
GateBell

Install GateBell

bash — Debian / Ubuntu
$ sudo apt install gatebell
bash — Arch Linux
$ yay -S gatebell
bash — RHEL / Fedora
$ sudo dnf install -y gatebell
2
GateBell

Configure your first alert channel

Add at least one notification channel. Slack webhook is recommended for team environments.

/etc/gatebell/alerts.conf
[slack]
enabled = true
webhook_url = https://hooks.slack.com/services/YOUR/WEBHOOK/URL
channel = #security
on_events = login,attempt,ban
3
GateBell

Enable and start

bash
$ sudo systemctl enable --now gatebell
✓ GateBell active — watching 3 interfaces
4
GateBell

Test your alert channel

Send a test notification to verify your setup is working before relying on it in production.

bash
$ gatebell test-alert
✓ Test notification sent to slack#security
✓
GateBell

GateBell is now watching your server

gatebell — live log
user@server:~$ gatebell status

● gatebell running uptime: 2m
● watching eth0, lo, docker0
● alerts slack#security
● ban list 0 active bans

[14:02:01] LOGIN [email protected] LAN · known
user@server:~$

No SSH config changes needed

GateBell integrates with PAM (Pluggable Authentication Modules) to intercept SSH events. No changes to sshd_config are required.

Full GateBell documentation ›
Pro tip: Add your office IP range to /etc/gatebell/rules.conf as an allow silent=true rule to prevent alert fatigue from your own team's connections.
Alert channels supported
Slack Discord Email PagerDuty Webhook

RouteChecker

Network route analysis and BGP path diagnostics — web-based, no installation required.

RouteChecker is a web application — there is nothing to install on your server. Simply visit the website, enter the IP address, hostname or subnet you want to analyse, and get a detailed route breakdown in seconds.

  • No installation or account required to use basic features
  • Trace BGP route paths from multiple global vantage points
  • Per-hop latency breakdown with geographic context
  • AS path inspection with autonomous system details
  • Historical route comparison — track changes over time
  • API access available for automated route monitoring
Open RouteChecker View Documentation ›

routechecker.co.uk

RouteChecker has its own dedicated website with full documentation, API reference and a built-in route analysis interface. No Petacomm account required.

Visit routechecker.co.uk ›
What RouteChecker analyses
  • BGP route paths and AS hop sequences
  • Per-hop round-trip latency (RTT)
  • IP geolocation per hop
  • Route origin validation (ROA/RPKI)
  • Historical route change detection
  • Reachability from 15+ global PoPs

    • Next steps

    Once your tools are running, here's what to do next.

    Read the full documentation
    Detailed CLI reference, configuration options, API docs and real-world examples for every tool.
    Go to Documentation
    Harden your server
    Apply CIS Level 2 benchmarks, FIPS 140-2 mode and SSH hardening with a single command.
    Security Guide
    Join the community
    Ask questions, share configurations and contribute to Petacomm on GitHub and Discord.
    Community Forum

    Need help with setup?

    Our support team and community are ready to help. Enterprise customers receive dedicated onboarding assistance.

    Contact Support GitHub Issues