### Astroluma Application

The Astroluma application template provides an easy way to deploy the Astroluma service on your Unraid server.

**Template Features:**
- Host network mode for optimal performance
- Configurable environment variables
- Persistent storage for uploads
- Automatic container restart

### Astroluma MongoDB

The MongoDB template provides the database backend required for the Astroluma application.

**Template Features:**
- Exposed port 27017 for database access
- Persistent storage for database files
- Bridge network mode for security
- Compatible with MongoDB 6.0

## Installation

1. Add template repository to Unraid:
   - Open the Unraid GUI

2. Install MongoDB container first:
   - Search for "Astroluma-MongoDB"
   - Configure the container paths:
     - Set host path for `/data/db` to `/mnt/user/appdata/astroluma/mongodb`
   - Click "Apply"

3. Install Astroluma application:
   - Search for "Astroluma"
   - Configure the container paths:
     - Set host path for uploads to `/mnt/user/appdata/astroluma/uploads`
   - Review and adjust environment variables if needed
   - Click "Apply"

## ⚙️ Configuration

### Astroluma Application Template

**Environment Variables:**
- `PORT`: Application port (default: 8000)
- `NODE_ENV`: Environment mode (default: production)
- `SECRET_KEY`: Application secret key
- `MONGODB_URI`: MongoDB connection string

**Volumes:**
- `/app/storage/uploads`: Directory for file uploads
  - Default path: `/mnt/user/appdata/astroluma/uploads`

### MongoDB Template

**Ports:**
- 27017: MongoDB database port

**Volumes:**
- `/data/db`: MongoDB data directory
  - Default path: `/mnt/user/appdata/astroluma/mongodb`

## Security Recommendations

1. Change default environment variables:
   - Generate a new `SECRET_KEY`
   - Modify default MongoDB connection string if needed

2. Use secure passwords:
   - Consider adding MongoDB authentication
   - Store sensitive information using Unraid's secrets management

3. Regular updates:
   - Keep containers updated using Unraid's update manager
   - Monitor for security advisories

## Troubleshooting

### Common Issues

1. Container fails to start:
   - Check Unraid Docker logs
   - Verify all required paths exist
   - Ensure no port conflicts

2. Application can't connect to MongoDB:
   - Confirm MongoDB container is running
   - Check network settings
   - Verify MongoDB connection string

3. Upload issues:
   - Check folder permissions
   - Verify path mappings
   - Ensure sufficient disk space

### Logs

To view container logs in Unraid:
1. Go to the Docker tab
2. Click on the container name
3. Click "Logs" to view the container's output

## Template Maintenance

### Updates

1. Updating templates:
   - Templates are version controlled
   - New versions will appear in Unraid's update manager
   - Always backup data before major updates

2. Backup recommendations:
   - Regular backup of `/mnt/user/appdata/astroluma/`
   - Export container configurations
   - Document any custom settings