Skip to content

Documentation

Jump to bottom
Suryaprakash edited this page Jul 27, 2026 · 1 revision

Documentation

Complete documentation for Nexora — installation, configuration, usage, and administration.

Quick Start

# docker-compose.yml
services:
  nexora:
    image: ghcr.io/suryaprakash251201/nexora:latest
    ports:
      - "80:80"
    volumes:
      - ./data:/app/data
    restart: unless-stopped
docker compose up -d
# Open http://localhost

Configuration

Variable Default Description
NEXORA_LISTEN_ADDR :8080 HTTP listen address
NEXORA_DATA_DIR ./data Data directory
NEXORA_DATABASE_PATH $DATA_DIR/nexora.db SQLite path
NEXORA_DATABASE_URL — PostgreSQL DSN
NEXORA_SESSION_SECRET auto 32-byte hex
NEXORA_THUMBNAIL_CACHE_DIR $DATA_DIR/cache/thumbnails Thumbnail cache
NEXORA_LOG_LEVEL info debug/info/warn/error
NEXORA_SECURE_COOKIES false Require HTTPS
NEXORA_CORS_ORIGINS — Comma-separated

User Guide

Navigation

  • Sidebar: Roots, views (Home, Search, Trash, Favorites, Recents)
  • Breadcrumb: Clickable path segments
  • Toolbar: Search, filter, sort, view mode, upload, new folder/file

File Operations

Action Shortcut
Open Enter / Double-click
Select Space / Click checkbox
Rename F2
Delete Delete
Copy Ctrl+C
Download Ctrl+Shift+S
Share Ctrl+Shift+L

Selection Mode

  1. Click ⋯ menu → Select
  2. Action bar appears: Download, Move, Copy, Share, Delete, Clear
  3. Click Clear or deselect all to exit

Search & Filters

  • Full-text across names, content, tags
  • Filters: type, date range, size, tags, favorites
  • Saved searches for quick access

Administration

User Management

nexora user create --username alice --role user
nexora user promote alice --role admin

Root Management

nexora root create --name "Backups" --path /mnt/backups --permission write
nexora root grant-access --root Backups --user alice --permission write

Maintenance

Task Command
Reindex search nexora search reindex
Purge trash (>30d) nexora trash purge --older-than 30d
Vacuum database nexora db vacuum

nginx Reverse Proxy

server {
    listen 443 ssl http2;
    server_name files.example.com;

    client_max_body_size 10G;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Backup

sqlite3 /app/data/nexora.db ".backup /backup/nexora-$(date +%F).db"
tar -czf /backup/config-$(date +%F).tar.gz /app/data/*.toml

Related Pages

Clone this wiki locally