Files
trading_bot_v4/SETTINGS_SETUP.md
mindesbunister c970559451 docs: Add settings management setup guide
- Document .env permission requirements (chmod 666)
- Explain customizable TP size feature
- Provide example trading strategies
- Security notes for production deployments
2025-10-24 15:36:37 +02:00

61 lines
2.1 KiB
Markdown

# Settings Management Setup
## Initial Setup
After deploying the trading bot, you need to make the `.env` file writable by the container:
```bash
chmod 666 /home/icke/traderv4/.env
```
This allows the web UI to save settings changes directly to the `.env` file.
## Security Note
The `.env` file contains sensitive information (private keys, API keys). The file permissions of `666` (rw-rw-rw-) allow the containerized application to write settings, but the file is still protected by:
1. File system permissions (only accessible on the host)
2. Docker isolation (container runs as non-root user)
3. Network isolation (not exposed to internet)
For production environments, consider:
- Using secrets management (e.g., Docker secrets, Kubernetes secrets)
- Environment variable injection from secure vaults
- Read-only .env with separate settings database
## How It Works
1. User edits settings in web UI at http://10.0.0.48:3001/settings
2. Click "Save Settings" → API writes to `/app/.env` (mounted from host)
3. Click "Restart Bot" → Watcher restarts container
4. Container reloads settings from updated .env file
5. New configuration takes effect
## Take Profit Configuration
You can now customize BOTH the price level AND the position size for each TP:
### TP1 (Take Profit 1)
- **Price %**: When to trigger the exit (e.g., +0.7% = exit at 0.7% profit)
- **Size %**: What % of position to close (e.g., 60 = close 60% of position)
### TP2 (Take Profit 2)
- **Price %**: When to trigger the second exit (e.g., +1.5% = exit at 1.5% profit)
- **Size %**: What % of REMAINING position to close (e.g., 100 = close rest)
### Example Strategy
**Conservative (70/30 split):**
- TP1: +0.5% price, 70% size → Lock in most profit early
- TP2: +2.0% price, 30% size → Let remainder run
**Aggressive (30/70 split):**
- TP1: +1.0% price, 30% size → Take small profit
- TP2: +3.0% price, 70% size → Let most position run for bigger gains
**Balanced (50/50 split - default):**
- TP1: +0.7% price, 50% size
- TP2: +1.5% price, 50% size
The risk calculator in the web UI will dynamically show expected gains based on your settings.