Fixes to the map display and several other bugs
This commit is contained in:
@@ -1,5 +1,4 @@
|
||||
# Services
|
||||
|
||||
Changemaker Lite includes several powerful services that work together to provide a complete documentation and development platform. Each service is containerized and can be accessed through its dedicated port.
|
||||
|
||||
## Available Services
|
||||
@@ -84,6 +83,15 @@ Changemaker Lite includes several powerful services that work together to provid
|
||||
- Simple and fast interface
|
||||
- No user registration required
|
||||
|
||||
### [Map](map.md)
|
||||
**Port: 3000** | Canvassing and community organizing application
|
||||
<div class="gitea-widget" data-repo="admin/changemaker.lite"></div>
|
||||
- Interactive map for door-to-door canvassing
|
||||
- Location and contact management
|
||||
- Admin panel and QR code walk sheets
|
||||
- NocoDB integration for data storage
|
||||
- User authentication and access control
|
||||
|
||||
## Service Architecture
|
||||
|
||||
```
|
||||
@@ -101,92 +109,10 @@ Changemaker Lite includes several powerful services that work together to provid
|
||||
│ NocoDB │ │ PostgreSQL │ │ PostgreSQL │
|
||||
│ :8090 │ │ (listmonk-db) │ │ (root_db) │
|
||||
└─────────────────┘ │ :5432 │ │ :5432 │
|
||||
│ └─────────────────┘ └─────────────────┘
|
||||
└──────────────────────────────────────────────────────┘
|
||||
```
|
||||
└─────────────────┘ └─────────────────┘
|
||||
|
||||
## Getting Started
|
||||
|
||||
1. **Start all services**: `docker compose up -d`
|
||||
2. **Check service status**: `docker compose ps`
|
||||
3. **View logs**: `docker compose logs [service-name]`
|
||||
4. **Stop services**: `docker compose down`
|
||||
|
||||
## Service Dependencies
|
||||
|
||||
- **Listmonk** depends on **PostgreSQL** (listmonk-db)
|
||||
- **NocoDB** depends on **PostgreSQL** (root_db)
|
||||
- **Static Server** serves content built by **MkDocs**
|
||||
- **n8n** can integrate with all other services
|
||||
- All services share the `changemaker` network
|
||||
|
||||
## Environment Configuration
|
||||
|
||||
Services are configured through environment variables in your `.env` file:
|
||||
|
||||
```env
|
||||
# Port configurations
|
||||
CODE_SERVER_PORT=8888
|
||||
LISTMONK_PORT=9000
|
||||
LISTMONK_DB_PORT=5432
|
||||
MKDOCS_PORT=4000
|
||||
MKDOCS_SITE_SERVER_PORT=4001
|
||||
N8N_PORT=5678
|
||||
|
||||
# User and group IDs
|
||||
USER_ID=1000
|
||||
GROUP_ID=1000
|
||||
|
||||
# Database configuration
|
||||
POSTGRES_USER=listmonk
|
||||
POSTGRES_PASSWORD=your_password
|
||||
POSTGRES_DB=listmonk
|
||||
|
||||
# n8n configuration
|
||||
N8N_ENCRYPTION_KEY=your_encryption_key
|
||||
N8N_USER_EMAIL=admin@example.com
|
||||
N8N_USER_PASSWORD=your_password
|
||||
```
|
||||
|
||||
## Monitoring and Maintenance
|
||||
|
||||
### Health Checks
|
||||
```bash
|
||||
# Check all services
|
||||
docker compose ps
|
||||
|
||||
# Check specific service logs
|
||||
docker compose logs listmonk-app
|
||||
docker compose logs code-server
|
||||
```
|
||||
|
||||
### Updates
|
||||
```bash
|
||||
# Pull latest images
|
||||
docker compose pull
|
||||
|
||||
# Restart with new images
|
||||
docker compose down && docker compose up -d
|
||||
```
|
||||
|
||||
### Backups
|
||||
- **PostgreSQL**: Regular database backups
|
||||
- **n8n**: Export workflows and credentials
|
||||
- **Code Server**: Backup configuration and workspace
|
||||
- **MkDocs**: Version control your documentation
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Common Issues
|
||||
|
||||
1. **Port Conflicts**: Ensure ports are not used by other applications
|
||||
2. **Permission Issues**: Check `USER_ID` and `GROUP_ID` settings
|
||||
3. **Network Issues**: Verify services can communicate through the `changemaker` network
|
||||
4. **Data Persistence**: Ensure volumes are properly mounted
|
||||
|
||||
### Getting Help
|
||||
|
||||
- Check individual service documentation
|
||||
- Review container logs for error messages
|
||||
- Verify environment variable configuration
|
||||
- Test network connectivity between services
|
||||
┌─────────────────┐
|
||||
│ Map │
|
||||
│ :3000 │
|
||||
└─────────────────┘
|
||||
```
|
||||
Reference in New Issue
Block a user