Introduction

Welcome to ProjectSpecter documentation

ProjectSpecter Documentation

Welcome to ProjectSpecter documentation! This guide will help you understand and work with our infrastructure setup.

What is ProjectSpecter?

ProjectSpecter is a modern, containerized infrastructure solution built on:

• Traefik - Advanced reverse proxy and load balancer
• Descope - Enterprise authentication and authorization
• Docker - Container orchestration
• Cloudflare - DNS and security

Quick Navigation

• New to ProjectSpecter? Start with Quickstart
• Understanding the architecture? Read Architecture Overview
• Setting up locally? Follow Initial Setup
• Need help? Check Troubleshooting

Key Features

✅ Automatic SSL/TLS Certificates - Via Let’s Encrypt and Cloudflare DNS ✅ Enterprise Authentication - Integrated Descope authentication ✅ Advanced Routing - Traefik v2.11 with middleware support ✅ Infrastructure as Code - Docker Compose for reproducible deployments ✅ Multi-Domain Support - Easily add services across subdomains

Current Deployment

• Admin Server: 209.141.33.10
• Primary Domain: starfleet-command.dev
• Dashboard: https://traefik.starfleet-command.dev
• Auth: https://auth.starfleet-command.dev

Documentation Structure

docs/
├── introduction.md          # This file
├── quickstart.md           # Quick start guide
├── architecture.md         # System architecture
├── components/             # Component documentation
├── infrastructure/         # Infrastructure guides
├── configuration/          # Configuration files
├── guides/                 # How-to guides
├── api-reference/          # API documentation
└── troubleshooting/        # Troubleshooting guides

Getting Started

Prerequisites

• Docker and Docker Compose installed
• SSH access to VPS
• Domain registered and DNS configured

Installation

1. Clone the repository
2. Copy .env.example to .env
3. Configure your domain in Cloudflare
4. Deploy services: docker compose up -d

See Initial Setup Guide for detailed instructions.

Architecture Overview

ProjectSpecter uses a layered architecture:

┌─────────────────────────────────────┐
│         Client Requests             │
└──────────────┬──────────────────────┘
               │ HTTPS (443) / HTTP (80)
┌──────────────▼──────────────────────┐
│  Traefik Reverse Proxy              │
│  - Route matching                   │
│  - Load balancing                   │
│  - Middleware application           │
└──────────────┬──────────────────────┘
               │ Internal Docker Network
┌──────────────▼──────────────────────┐
│  Middleware Layer                   │
│  - Descope Authentication           │
│  - Request transformation           │
└──────────────┬──────────────────────┘
               │
┌──────────────▼──────────────────────┐
│  Application Services               │
│  - Custom applications              │
│  - Databases                        │
│  - Microservices                    │
└─────────────────────────────────────┘

Core Components

Traefik

Advanced reverse proxy that handles:

• HTTP to HTTPS redirection
• SSL/TLS termination
• Route matching and load balancing
• Middleware application
• Service discovery

Dashboard: https://traefik.starfleet-command.dev

Descope Authentication

Enterprise-grade authentication providing:

• Single Sign-On (SSO)
• Multi-factor authentication (MFA)
• Magic links
• Passkeys
• User management

Login: https://auth.starfleet-command.dev

Docker Compose

Infrastructure definition with:

• Service definitions
• Network configuration
• Volume management
• Environment variables

Important Files

File	Purpose
docker-compose.yml	Traefik service definition
descope-auth/docker-compose.yml	Descope auth service
traefik.yml	Traefik static configuration
mint.json	This documentation structure

Support & Resources

• Traefik Documentation: https://doc.traefik.io/
• Descope Documentation: https://docs.descope.com/
• Docker Documentation: https://docs.docker.com/
• Cloudflare Documentation: https://developers.cloudflare.com/

Next Steps

1. Read the Quickstart Guide
2. Review Architecture Overview
3. Follow Initial Setup
4. Deploy your first service

---

Last Updated: February 18, 2026 Documentation Version: 1.0 Status: ✅ Active