Overview
The Installed Apps page is your control centre for managing every application running on your Organism platform. From here you can monitor status, perform actions, and access each application's web interface.
Navigate to Installed Apps by clicking Installed in the sidebar.
App List
Each installed application is displayed as a card showing:
| Element | Description |
|---|---|
| App icon | Visual identifier |
| App name | Name of the application |
| Status | Current running state (see below) |
| Version | Installed version number |
| Containers | Number of containers in the app stack |
| Actions | Quick action buttons |
The list refreshes automatically every 5 seconds to keep status information current.
Status Indicators
Each application shows a colour-coded status:
| Status | Colour | Meaning |
|---|---|---|
| Running | 🟢 Green | All containers are healthy and responding |
| Starting | 🟡 Yellow | Containers are booting up |
| Stopped | ⚪ Grey | All containers are stopped |
| Error | 🔴 Red | One or more containers have failed health checks |
| Partially Running | 🟡 Yellow | Some containers are running, others are not |
Container Details
Click on any application to expand its detailed view:
The detail view shows each container in the application stack:
| Field | Description |
|---|---|
| Container name | Docker container name (e.g. wisejnrs-therapy-app) |
| Image | Docker image and tag |
| Status | Individual container health |
| Ports | Host port → container port mappings |
| Uptime | How long the container has been running |
| CPU / Memory | Current resource usage |
Actions
Start
Starts all containers in the application in the correct order — typically database first, then API services, then the web interface.
Stop
Gracefully stops all containers. Application data is preserved in Docker volumes and will be available when you start the app again.
Restart
Stops and then starts all containers. This is useful when:
- An application is behaving unexpectedly
- You've changed configuration settings
- A container is in an error state
Open
Opens the application's web interface in a new browser tab. The URL is based on the port mapping configured during installation (e.g. http://localhost:8085).
Uninstalling an Application
To uninstall an application:
- Click on the application to expand its details
- Click the Uninstall button
- Choose whether to preserve or delete data volumes:
- Keep data — removes containers but preserves database and file volumes (you can reinstall later without losing data)
- Delete everything — removes containers AND all associated data volumes permanently
- Confirm the uninstall
The uninstall process:
- Stops all running containers
- Removes containers from the Docker engine
- Removes the application's Docker network
- Optionally removes data volumes
- Updates the Organism database
Update Available
When a newer version of an application is available, an Update Available badge appears on the app card. Click it to view the update details and start the upgrade process.
Updates are non-destructive — your data and configuration are preserved. Organism pulls the new container images and recreates the containers with the updated versions.
Related Documentation
- Dashboard — Home screen with app springboard
- App Store — Install new applications
- Monitoring — System resource charts
- Logs — View container logs