Documentation

Installation & Deployment

Development (Local)

To contribute or test with dev tools (Mailpit, Hot-reload...):

git clone https://gitlab.com/militant1/millitant.git
cd millitant
docker compose up -d --build

Professional Self-Hosting (Recommended)

The simplest and fastest method. Uses the pre-built official image.

1. Download files:

curl -O https://gitlab.com/militant1/millitant/-/raw/main/docker-compose.hosting.yml
curl -O https://gitlab.com/militant1/millitant/-/raw/main/.env.template

2. Configure:

cp .env.template .env
nano .env # Fill in your credentials (DB, SMTP...)

3. Launch:

docker compose -f docker-compose.hosting.yml up -d

Classic Installation (Source)

For those who prefer to build the image themselves from source code:

1. Download the file:

curl -O https://gitlab.com/militant1/millitant/-/raw/main/docker-compose.prod.yml

2. Launch:

docker compose -f docker-compose.prod.yml up -d

Advanced Network Configuration

If you use Cloudflare or a reverse proxy, MILITANT automatically detects the real IP of your users.

All Apache configuration (`mod_remoteip`) is handled by our hot update script.

# Apply Cloudflare config to your server
sudo ./hot_update.sh

Installation via CasaOS

1. Open App Center then click on Custom Install (top right)
2. Click on the Docker Compose icon (top right of the modal)
3. Paste the content of the docker-compose.casaos.yml file
4. Click on Install
5. Access http://CASAOS-IP:8080
6. Create the admin account: http://CASAOS-IP:8080/setup_admin.php

🛡️ Fail2Ban Protection

Fail2Ban is enabled by default on CasaOS to protect against brute force attacks by banning IPs after several failed attempts.

Check Status

# Check if Fail2Ban is running
docker ps | grep fail2ban

# Jail status
docker exec militant-fail2ban fail2ban-client status

# Details of the militant-auth jail
docker exec militant-fail2ban fail2ban-client status militant-auth

Default Configuration

💾 Automatic Backup

Automatically backup your instance (code + database) to Docker Hub.

Run a Manual Backup

sudo /usr/local/bin/militant-backup.sh

🏥 Health Check Endpoints

MILITANT exposes health endpoints to monitor service status in real-time.

Public Endpoints (Status Page)

These endpoints are publicly accessible and do not reveal any sensitive information:

https://militant.revlibertaire.com/health-public.php
https://api.militant.revlibertaire.com/health-public.php

JSON Response:

{
  "status": "ok",
  "timestamp": 1771206234
}

Possible Values:

• ok - Service operational ✅
• degraded - Service degraded ⚠️
• partial_outage - Partial outage 🔴

Private Endpoints (Internal Monitoring)

These endpoints are restricted to local access (localhost and internal networks) and provide infrastructure details:

https://militant.revlibertaire.com/health.php
https://api.militant.revlibertaire.com/health.php

Detailed Response (localhost only):

{
  "status": "ok",
  "timestamp": 1771206234,
  "services": {
    "database": "ok",
    "storage": "ok",
    "php": "ok"
  }
}

External Access:

{
  "error": "Access denied",
  "status": "forbidden"
}

Public Status Page

Check service status in real-time:

https://militant.revlibertaire.com/status.html

The page automatically queries public endpoints every 30 seconds.

Features

Security & Account

• Two-factor authentication (2FA) via TOTP (Google Authenticator, Authy...)
• Passkeys (WebAuthn): Biometric login (fingerprint, face)
• Passwords hashed with Argon2ID
• Integrated Fail2Ban (anti-brute force protection)
• Strict CSRF, XSS, and Rate Limiting protection

Posts

• Posts with photos/videos (up to 500MB)
• Rich Link Previews (automatic link previews)
• Emoji reactions
• Nested comments with replies
• @mentions with notifications

Social

• Private messages with basic encryption
• Fleeting stories (24h) with touch navigation
• Chronological "For You" / "Subscriptions" feed
• Friends and followers system
• Unified global search

Groups & Collectives (Messaging V2)

A complete integrated instant messaging system, designed for collective organization.

• Horizontal Governance: All members are admins by default. Collegiate management of members and settings.
• Ephemeral Messages: Set up automatic self-destruction (from 1 minute to 7 days) for your sensitive discussions.
• Audio & Media: Direct voice recording (iOS/Android compatible), photo and video sharing with integrated lightbox.
• Secure Exchanges: Strict isolation of messaging data and alerts in case of session hijacking attempts.
• Membership Requests: Validation system for private groups with customizable questionnaires.

Internationalization

• Interface translated into French, English, Spanish, Esperanto
• Automatic translation of posts and messages (LibreTranslate)
• Automatic language detection

📱 Mobile Interface

An experience natively optimized for smartphones without an extra application.

• Bottom navigation bar: Quick access to Home, Search, Messages, Profile.
• Offcanvas Menu: Lateral access to all advanced features.
• Adaptive Header: Logo and essential actions always visible.
• PWA Badge: Native notification support on Android.

Configuration (.env)

Community Moderation

No hierarchy. Decisions by consensus.

• Reports processed by community vote
• 70% consensus required
• Moderators elected and revocable by all

Languages

Available in: French, English, Spanish, Esperanto

Add a language: create lang/xx.php

PWA Application

MILITANT is a Progressive Web App (PWA) installable on mobile and desktop. It even works offline.

On Android

1. Open militant.revlibertaire.com in Chrome
2. Tap the menu ⋮ (three dots at the top right)
3. Select "Add to Home Screen"
4. Confirm by tapping "Add"
5. The MILITANT icon appears on your home screen

On iPhone / iPad

1. Open militant.revlibertaire.com in Safari
2. Tap the Share button (at the bottom of the screen)
3. Scroll down and select "Add to Home Screen"
4. Tap "Add" at the top right
5. The MILITANT icon appears on your home screen

On Computer (Chrome, Edge)

1. Open militant.revlibertaire.com
2. Click the installation icon in the address bar
3. Or go to the menu ⋮ → "Install MILITANT"
4. The application opens in its own window