Built-in Services
Aether Desktop manages five container-based services. Start and stop them from the dashboard or CLI.
Aether IDE
A full VS Code compatible development environment running in a container.
| Property | Value |
|---|---|
| Port | 8888 (HTTP), 2222 (SSH) |
| Domain | ide.aether.localhost (with Traefik) |
| Workspace | Mounted at /home/jovyan/work |
Features:
- Extensions marketplace
- Integrated terminal and debugger
- Git integration
- SSH access for remote editors
- GrepAI pre-installed and auto-running
aether-desktop launch --project ~/my-projectAetherTerm
AI-assisted terminal with natural language command generation and safety features.
| Property | Value |
|---|---|
| Port | 57575 |
| Domain | terminal.aether.localhost (with Traefik) |
Features:
- Natural language → shell command translation
- Dangerous command detection (prevents accidental
rm -rf, credential leaks) - Persistent sessions
- Web-based interface
aether-desktop launch terminalAperture LLM Gateway
An OpenAI-compatible API endpoint that unifies access to multiple LLM providers.
| Property | Value |
|---|---|
| Port | 4000 |
| Domain | aperture.aether.localhost (with Traefik) |
Aperture starts automatically when IDE or Terminal launches. AI tools inside the environment can call http://localhost:4000 as an OpenAI-compatible endpoint.
OVMS (OpenVINO Model Server)
Local AI model inference engine for running models on your hardware.
| Property | Value |
|---|---|
| Ports | 8000 (REST), 9000 (gRPC) |
| Domain | ovms.aether.localhost (with Traefik) |
| Model storage | %LOCALAPPDATA%/aether-desktop/models/ |
Features:
- GPU/NPU hardware acceleration (auto-detected)
- Model download and management from the Settings panel
- Embedding models for GrepAI
- LLM models for local inference
Networking
When Traefik proxy is enabled, all services are accessible via *.aether.localhost domains (RFC 6761 compliant). Without Traefik, use localhost:<port> directly.
| Service | Domain | Direct Port |
|---|---|---|
| IDE | ide.aether.localhost | 8888 |
| Terminal | terminal.aether.localhost | 57575 |
| OVMS | ovms.aether.localhost | 8000 / 9000 |
| Aperture | aperture.aether.localhost | 4000 |
| Traefik Dashboard | traefik.aether.localhost | — |
Starting and Stopping
From the dashboard, use the start/stop buttons. From the CLI:
# Start allaether-desktop launch
# Start specific serviceaether-desktop launch terminal
# Stop specific serviceaether-desktop stop terminal
# Stop allaether-desktop stop