Applications
Overview
The Applications section lets you manage Fenwave applications. These applications are defined as blueprints and run locally via Docker Compose workspaces managed by the agent.
Application Tabs
The applications page is organized into four tabs:
- All Apps — All Fenwave available applications
- Running — Only currently active applications
- Stopped — Only stopped applications
- Templates — Pre-built application templates for quick use
Searching and Creating Applications
Search Applications
Use the Search field on the page to filter applications by name. Search updates results in real-time as you type.
Create New Application
Click the New App button to:
- Open the App Builder on Fenwave
- Design and configure a new application
- Start running the app locally once configured
Applications
Each application card displays comprehensive information and controls:
Card Layout
- Name — Application name
- Description — Application description
- Status Badge — Current state: Running, Stopped
- Update Notification (if status = draft) — Shows “Update available” badge when drafts are modified
Version Information
Draft Apps:
- Show single version number
Published Apps:
- Display latest and current versions separately
- Latest version shown with “(latest)” label
- Current local version shown with “(current)” label
- Combined as “(latest, current)” if both are the same
Metadata Section
Each app card displays four key metrics:
| Metric | Description |
|---|---|
| Containers | Number of running containers in the app |
| Last Run | When the app was last started (or “Never”) |
| Published By | User that published the app (if status = published) |
Action Buttons
Located at the bottom of each card:
Start / Stop / Restart
- Start — Launches all services defined in Docker Compose
- Stop — Gracefully stops all services
- Restart — Appears when running; stops then starts all services
Sync
- Sync — Updates the draft app configuration with the latest version from Fenwave
- Only appears when:
- Draft app is currently running
- Updates are available
- Button highlights when updates pending
- Shows “Synced” when up-to-date
Change Version
- Change Version — Switch to a different version of the app
- Only appears for published apps with multiple versions
- Opens version selection dialog showing:
- Version List — Displays all available versions sorted by published date (newest first)
- Version Details
- Confirmation Steps
View Logs
- Logs — Opens Logs page filtered to this app
- Shows startup and service logs with app-specific filtering
- Disabled if app has no containers
Clean
- Clean — Removes stopped app, clears workspace, reclaims disk space
- Only available for stopped apps
- Shows confirmation dialog before proceeding
- Can be used to free up space or reset an app
Pre-built Templates
The Templates tab provides ready-to-use application blueprints:
Available Templates
| Template | Components | Best For |
|---|---|---|
| MERN Stack | MongoDB, Express, React, Node.js | Full-stack JavaScript applications |
| Django + Postgres | Python Django, PostgreSQL | Python web apps with database |
| Laravel + MySQL | PHP Laravel, MySQL, Redis | PHP web apps with caching |
Using a Template
- Navigate to the Templates tab
- Click Use Template on the desired template
- Opens App Builder on Fenwave
- Configure app settings and customizations
- Start running the app locally when ready
Templates provide almost complete, pre-configured setups that you can further customize before running locally.
Removing Applications
To remove an app:
- Stop the app if running
- Click Clean button on stopped app card
- Confirm removal in dialog
- App workspace, containers, and volumes are deleted
⚠️ Note: Removing an app deletes only the local workspace. The application definition in Fenwave remains unchanged, allowing you to run it again later.
Related Documentation
- Logs — View startup logs and service logs
- Containers — Manage individual app services
- Metrics — Monitor app resource usage