Install on RHEL / Fedora

This guide covers installing Astromesh Node on RPM-based Linux distributions: RHEL 9+, Fedora 38+, CentOS Stream 9+, and AlmaLinux/Rocky Linux 9+.

Prerequisites

Requirement	Version	Check
RHEL / Fedora / CentOS	RHEL 9+ / Fedora 38+	cat /etc/os-release
systemd	250+	systemctl --version
Python	None — the package carries its own CPython 3.12 in /opt/astromesh/python (since v0.1.8)	—
Architecture	x86_64 only	uname -m
Network	Outbound to LLM provider or local Ollama	—

Download the Package

Node packages are attached to the node-v* releases on GitHub (the repository’s “latest” release is the core, so releases/latest/download/... does not find them):

VERSION=0.1.10
curl -LO https://github.com/monaccode/astromesh/releases/download/node-v${VERSION}/astromesh-node-${VERSION}-1.x86_64.rpm

Install

sudo dnf install ./astromesh-node-${VERSION}-1.x86_64.rpm

No system Python needed

Since v0.1.8 the package ships its own CPython (python-build-standalone, /opt/astromesh/python) and declares no Python dependency, so it installs on RHEL 9’s stock python3 3.9 unchanged. Packages up to v0.1.7 don’t work outside CI: they declared a python3-venv no RPM repository provides, and their venv pointed at the build machine’s interpreter — upgrade instead of working around them.

Verify the installation:

astromeshctl version

Expected output:

astromesh-cli 0.3.1
astromesh core 0.61.0

Configure

Run the interactive wizard to generate your configuration:

sudo astromeshctl init

For a non-interactive setup:

sudo astromeshctl init --role full --non-interactive

This creates /etc/astromesh/runtime.yaml, providers.yaml and, if you entered a provider API key, .env (loaded by the systemd unit). The package already installs sample agents in /etc/astromesh/agents/.

The wizard does not find its role profile in a packaged install

It prints Profile not found and writes an empty runtime.yaml. Copy the profile the package ships instead: sudo cp /etc/astromesh/profiles/full.yaml /etc/astromesh/runtime.yaml (or gateway, worker, inference, mesh-*).

See Configuration for the full runtime.yaml schema and the roles.

SELinux Considerations

The package ships no SELinux policy module. On systems with SELinux enforcing, if you encounter denials:

# Check for SELinux denials
sudo ausearch -c astromeshd -m avc

# Generate a local policy module if needed
sudo ausearch -c astromeshd -m avc | audit2allow -M astromesh_local
sudo semodule -i astromesh_local.pp

Firewall (firewalld)

To allow external access to the API port:

sudo firewall-cmd --permanent --add-port=8000/tcp
sudo firewall-cmd --reload

Start the Service

The package enables the unit but does not start it:

sudo systemctl start astromeshd

Check service status:

sudo systemctl status astromeshd

Expected output:

● astromeshd.service - Astromesh Agent Runtime Daemon
     Loaded: loaded (/lib/systemd/system/astromeshd.service; enabled)
     Active: active (running) since Fri 2026-03-20 10:00:00 UTC; 5s ago
   Main PID: 4521 (astromeshd)
     Memory: 128.0M

Verify

astromeshctl status

curl http://localhost:8000/v1/health

Log Access

# Follow live logs
sudo journalctl -u astromeshd -f

# Last 100 lines
sudo journalctl -u astromeshd -n 100

# Only errors
sudo journalctl -u astromeshd -p err

Filesystem Paths

Path	Purpose
/etc/astromesh/	Configuration files
/var/lib/astromesh/	Persistent state (memory, models)
/var/log/astromesh/	Audit logs (daemon logs go to journald)
/opt/astromesh/venv/	Virtualenv; astromeshd and astromeshctl are symlinked into /usr/bin/
/lib/systemd/system/astromeshd.service	systemd unit file

Upgrade

VERSION=0.1.10
curl -LO https://github.com/monaccode/astromesh/releases/download/node-v${VERSION}/astromesh-node-${VERSION}-1.x86_64.rpm
sudo dnf upgrade ./astromesh-node-${VERSION}-1.x86_64.rpm

The old package’s pre-remove script runs after the new one is installed, so the upgrade leaves the service stopped and disabled. Re-enable and start it, then verify:

sudo systemctl enable --now astromeshd
astromeshctl version
astromeshctl status

Uninstall

sudo dnf remove astromesh-node

Removing stops and disables the service.

To remove all configuration and data:

sudo rm -rf /etc/astromesh /var/lib/astromesh /var/log/astromesh /opt/astromesh
sudo userdel astromesh

Next Steps

• Configuration — Customize runtime.yaml and profiles
• CLI Reference — Full astromeshctl reference
• Troubleshooting — Common Linux issues