Welcome to the central knowledge base for the SmartHome infrastructure at CIIRC CTU.
This wiki documents how the SmartHome environment is designed, deployed, operated, and maintained. It is intended for researchers, developers, students, and administrators working with smart-home systems, automation, sensing, robotics, IoT, and related infrastructure.
New here? Start with these pages:
| Page | Description |
|---|---|
| Overview | What the SmartHome environment is and what it is used for |
| Architecture | Main components, networks, services, and data flows |
| Access | How to get access to services, devices, servers, and repositories |
| Devices | Inventory of sensors, actuators, gateways, cameras, and controllers |
| Runbooks | Operational procedures for common maintenance tasks |
| Troubleshooting | Known problems and how to fix them |
Documentation for servers, Docker deployments, reverse proxy configuration, storage, backups, monitoring, and networking.
Suggested pages:
Inventory and documentation for physical and virtual devices used in the SmartHome environment.
Suggested pages:
For each device, document:
Documentation for running software services connected to the SmartHome environment.
Suggested pages:
For each service, document:
Space for documenting experiments, datasets, prototypes, and research setups.
Suggested pages:
Each experiment should include:
Use runbooks for procedures that must be repeatable and safe.
Examples:
Runbook template:
# Runbook: Task Name
## Purpose
What this procedure is for.
## Preconditions
What must be true before starting.
## Steps
1. Step one
2. Step two
3. Step three
## Verification
How to confirm that the task succeeded.
## Rollback
How to revert the change if something goes wrong.
## Notes
Known caveats or links to related pages.
| Component | Description |
|---|---|
purity |
Main server hosting Docker-based services |
| Caddy | Reverse proxy and TLS termination |
| Docker Compose | Service deployment and lifecycle management |
| Wiki.js | This documentation system |
| PostgreSQL | Database backend for Wiki.js |
Server principles:
restart: unless-stopped.To keep this wiki useful:
<TOKEN> or <PASSWORD> when documenting commands.Good documentation should answer:
Check running Docker containers:
docker ps
List Docker projects:
ls /opt/docker
Check Caddy logs:
cd /opt/docker/proxy
docker compose logs -f caddy
Check Wiki.js logs:
cd /opt/docker/wiki
docker compose logs -f wiki
Test Wiki.js internally from Caddy:
cd /opt/docker/proxy
docker compose exec caddy wget -O- http://wiki:3000
Test public Wiki.js URL:
curl -I https://wiki.purity.ciirc.cvut.cz
| Area | Owner / Contact |
|---|---|
| SmartHome infrastructure | TBD |
| Server administration | TBD |
| Wiki.js administration | TBD |
| Device inventory | TBD |
| Research experiments | TBD |
Add names, emails, or team contacts here once ownership is clear.
Recommended pages to create first:
/overview/architecture/infrastructure/server-overview/infrastructure/docker-services/devices/inventory/services/home-assistant/services/mqtt/runbooks/troubleshooting/accessThis wiki should become the single source of truth for the SmartHome environment at CIIRC CTU.