Files
trading_bot_v4/docs/setup/SETTINGS_SETUP.md
mindesbunister 14d5de2c64 chore: Organize workspace structure - move docs, workflows, scripts to subdirectories
Organization:
- Created docs/ with setup/, guides/, history/ subdirectories
- Created workflows/ with trading/, analytics/, telegram/, archive/ subdirectories
- Created scripts/ with docker/, setup/, testing/ subdirectories
- Created tests/ for TypeScript test files
- Created archive/ for unused reference files

Moved files:
- 17 documentation files → docs/
- 16 workflow JSON files → workflows/
- 10 shell scripts → scripts/
- 4 test files → tests/
- 5 unused files → archive/

Updated:
- README.md with new file structure and documentation paths

Deleted:
- data/ (empty directory)
- screenshots/ (empty directory)

Critical files remain in root:
- telegram_command_bot.py (active bot - used by Dockerfile)
- watch-restart.sh (systemd service dependency)
- All Dockerfiles and docker-compose files
- All environment files

Validation:
 Containers running (trading-bot-v4, telegram-trade-bot, postgres)
 API responding (positions endpoint tested)
 Telegram bot functional (/status command tested)
 All critical files present in root

No code changes - purely organizational.
System continues running without interruption.

Recovery: git revert HEAD or git reset --hard cleanup-before
2025-10-27 12:59:25 +01:00

2.1 KiB

Settings Management Setup

Initial Setup

After deploying the trading bot, you need to make the .env file writable by the container:

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.