155 lines
4.9 KiB
Markdown
155 lines
4.9 KiB
Markdown
# SuiteCRM Docker — Containerized CRM Environment
|
|
|
|
**SuiteCRM 7.15.1** — vollständig containerisiert mit Docker Compose.
|
|
Ein Befehl, alles läuft: SuiteCRM + MariaDB + (optional) Redis.
|
|
|
|
## Systemanforderungen
|
|
|
|
- Docker 20.10+ und Docker Compose v2
|
|
- 2 GB RAM empfohlen (MariaDB Puffer)
|
|
|
|
## Schnellstart
|
|
|
|
```bash
|
|
# 1. Repository klonen
|
|
git clone https://git.kgessner.de/LuiiCode/sugar-crm.git
|
|
cd sugar-crm
|
|
|
|
# 2. Umgebungsvariablen anpassen
|
|
cp .env.example .env
|
|
nano .env # Passwörter ändern!
|
|
|
|
# 3. Starten
|
|
docker compose up -d
|
|
|
|
# 4. SuiteCRM Installation im Browser abschließen:
|
|
# http://localhost:8080
|
|
```
|
|
|
|
## Architektur
|
|
|
|
```
|
|
┌──────────────────────────────────────┐
|
|
│ Docker Compose │
|
|
│ │
|
|
│ ┌──────────┐ ┌──────────┐ │
|
|
│ │ SuiteCRM │ │ MariaDB │ Redis? │
|
|
│ │ :8080 │ │ :3307 │ :6379 │
|
|
│ │ PHP 8.1 │ │ 10.11 │ (opt.) │
|
|
│ │ Apache │ │ │ │
|
|
│ └──────────┘ └──────────┘ │
|
|
│ │ │ │
|
|
│ Volumes: Volumes: │
|
|
│ - upload - /var/lib/mysql │
|
|
│ - custom │
|
|
│ - config │
|
|
└──────────────────────────────────────┘
|
|
```
|
|
|
|
## Services
|
|
|
|
| Service | Image | Port | Profil |
|
|
|-----------|------------------|-------|---------------|
|
|
| suitecrm | Custom (PHP 8.1) | 8080 | standard |
|
|
| mariadb | mariadb:10.11 | 3307 | standard |
|
|
| redis | redis:7-alpine | 6379 | `redis`/`full`|
|
|
|
|
## Konfiguration
|
|
|
|
### Umgebungsvariablen (`.env`)
|
|
|
|
| Variable | Default | Beschreibung |
|
|
|-----------------------|-----------------------------|-------------------------|
|
|
| `SUITECRM_PORT` | 8080 | Webinterface-Port |
|
|
| `SUITECRM_SITE_URL` | http://localhost:8080 | Öffentliche URL |
|
|
| `MYSQL_PORT` | 3307 | DB-Port (Host) |
|
|
| `MYSQL_ROOT_PASSWORD` | change_this… | Root-Passwort |
|
|
| `MYSQL_DATABASE` | suitecrm | Datenbank-Name |
|
|
| `MYSQL_USER` | suitecrm | Datenbank-Nutzer |
|
|
| `MYSQL_PASSWORD` | change_this… | Nutzer-Passwort |
|
|
|
|
> ⚠️ **Sicherheit**: Immer `.env` Passwörter ändern vor erstem Start!
|
|
|
|
## Kommandos
|
|
|
|
```bash
|
|
# Grundbefehle
|
|
docker compose up -d # Alle Services starten
|
|
docker compose up -d redis # + Redis-Cache starten
|
|
docker compose down # Stoppen
|
|
docker compose down -v # Stoppen + ALLE DATEN LÖSCHEN
|
|
|
|
# Logs
|
|
docker compose logs -f suitecrm # SuiteCRM-Logs verfolgen
|
|
docker compose logs mariadb # DB-Logs
|
|
|
|
# Backup
|
|
docker compose exec mariadb mysqldump -u suitecrm -p suitecrm > backup.sql
|
|
tar -czf upload-backup.tar.gz -C /var/lib/docker/volumes/sugarcrmreponame_suitecrm_data/_data .
|
|
```
|
|
|
|
## SuiteCRM Installation (Erst-Start)
|
|
|
|
Nach `docker compose up -d` im Browser `http://localhost:8080` öffnen:
|
|
|
|
1. **License Agreement** → Akzeptieren
|
|
2. **System Check** → Alle Checks sollten grün sein
|
|
3. **Database Configuration**:
|
|
- Host: `mariadb`
|
|
- Database: `suitecrm`
|
|
- User: `suitecrm`
|
|
- Password: (aus `.env`)
|
|
4. **Site Configuration** → Admin-Nutzer anlegen
|
|
5. **Fertig!** SuiteCRM ist einsatzbereit.
|
|
|
|
## Redis aktivieren
|
|
|
|
```bash
|
|
# Mit Redis-Profil starten
|
|
docker compose --profile redis up -d
|
|
|
|
# Oder Full-Stack (alles inkl. Redis)
|
|
docker compose --profile full up -d
|
|
```
|
|
|
|
Redis-Konfiguration in SuiteCRM Admin → System → Redis:
|
|
- Host: `redis`
|
|
- Port: `6379`
|
|
|
|
## Elasticsearch (optional)
|
|
|
|
Für Volltextsuche kann Elasticsearch ergänzt werden. Dazu in `docker-compose.yml` einfügen:
|
|
|
|
```yaml
|
|
elasticsearch:
|
|
image: docker.elastic.co/elasticsearch/elasticsearch:7.17.24
|
|
container_name: suitecrm-es
|
|
environment:
|
|
- discovery.type=single-node
|
|
- xpack.security.enabled=false
|
|
volumes:
|
|
- es_data:/usr/share/elasticsearch/data
|
|
networks:
|
|
- suitecrm-net
|
|
```
|
|
|
|
## Docker Image bauen & pushen
|
|
|
|
```bash
|
|
# Lokal bauen
|
|
docker build -t suitecrm:7.15.1 .
|
|
|
|
# In Gitea Registry pushen
|
|
docker tag suitecrm:7.15.1 git.kgessner.de/luiicode/sugar-crm:7.15.1
|
|
docker login git.kgessner.de
|
|
docker push git.kgessner.de/luiicode/sugar-crm:7.15.1
|
|
```
|
|
|
|
## CI/CD
|
|
|
|
Bei jedem Push auf `main` baut Gitea Actions das Image automatisch und pusht es in die Gitea Container Registry. Workflow: `.gitea/workflows/docker-build.yml`
|
|
|
|
---
|
|
|
|
**Version**: SuiteCRM 7.15.1 | **PHP**: 8.1 | **MariaDB**: 10.11
|