Appliance Operations and Maintenance¶

This document covers the management, maintenance, and troubleshooting commands for your Reemo appliance.

Main commands¶

The appliance.sh script manages the lifecycle of your installation.

Command	Description
`sudo bash appliance.sh status`	Service status
`sudo bash appliance.sh update`	Update all services (with auto rollback)
`sudo bash appliance.sh update <service>`	Update a specific service
`sudo bash appliance.sh rollback`	Manual rollback to the previous version
`sudo bash appliance.sh uninstall`	Complete uninstallation

Script options¶

Option	Description	Default
`-r REGISTRY`	Docker Registry	`registry.reemo.io`
`-u USERNAME`	Username for registry authentication	—
`-p PASSWORD`	Password for registry authentication	—
`-t TAG`	Image tag	`latest`
`-c CONFIG`	Path to `config.json`	`./config.json`
`-h`	Displays help	—

Examples¶

# Full update
sudo bash appliance.sh -u YOUR_USERNAME -p YOUR_PASSWORD update

# Update a single service
sudo bash appliance.sh -u YOUR_USERNAME -p YOUR_PASSWORD update applianceproxy

# Status check (no credentials needed)
sudo bash appliance.sh status

# Automatic rollback (in case of post-update issue)
sudo bash appliance.sh rollback

Update¶

Execute the update action (providing your credentials if necessary):

sudo bash appliance.sh -u YOUR_USERNAME -p YOUR_PASSWORD update

The process is automatic with built-in rollback: 1. Snapshot of the current version. 2. Pull of new images and restart. 3. Verification of proper operation for 15 seconds. 4. If failed: automatic rollback to the previous version.

Viewing logs¶

The logs of the three services are sent to the host system’s syslog.

# Real-time logs of a service
journalctl -t reemo_applianceprovision -f
journalctl -t reemo_applianceproapi -f
journalctl -t reemo_applianceproxy -f

# All Reemo logs together
journalctl -t 'reemo_*' -f

# The last 100 lines
journalctl -t reemo_applianceproapi -n 100

# Logs from a specific period
journalctl -t reemo_applianceprovision --since "1 hour ago"

Standard Docker commands also work:

docker logs -f applianceproapi
docker ps

Uninstallation¶

To remove Docker containers and networks:

sudo bash appliance.sh uninstall

To also permanently delete local certificates and secrets:

sudo rm -rf /opt/appliance

Reemo Support¶

In case of a malfunction requiring help from the Reemo support team:

Check the status with sudo bash appliance.sh status.
Check the logs with journalctl -t 'reemo_*' -n 100.
Verify your network flows (matrices in the architecture documentation).

If the problem persists, contact support, systematically attaching the results of these commands:

sudo bash appliance.sh status > status.txt
journalctl -t 'reemo_*' -n 200 > logs.txt

Technical security notes¶

Network protocol: WebRTC mode offers the best performance (latency, throughput). Use WebSocket only if your network blocks UDP or imposes a strict HTTP proxy.
Internal encryption: Internal communications between appliance components are protected end-to-end by mTLS, with a PKI auto-generated during installation (10-year validity).