DeepSite v3 Local Installation Guide

1

System Requirements

Before we begin, ensure your system meets these requirements:

  • Linux-based OS (Ubuntu 20.04+ recommended)
  • Docker Engine installed
  • Docker Compose v2.0+
  • Minimum 4GB RAM (8GB recommended)
  • 50GB free disk space
  • Stable internet connection
2

Install Docker & Dependencies

Terminal Commands
# First, install Docker using your package manager
# For Ubuntu/Debian:
sudo apt update
sudo apt install -y docker.io docker-compose

# For CentOS/RHEL:
sudo yum install -y docker docker-compose-plugin

# For Arch Linux:
sudo pacman -S docker docker-compose

# Start and enable Docker service
sudo systemctl enable --now docker

# Add your user to docker group (no sudo needed)
sudo usermod -aG docker $USER
newgrp docker

# Verify installation
docker run hello-world

After running these commands, Docker should be installed. The "hello-world" container should run successfully.

3

Download DeepSite v3

Terminal Commands
# Create project directory
mkdir deepsite-v3 && cd deepsite-v3

# Create minimal docker-compose.yml
cat > docker-compose.yml <

This will download the latest stable release of DeepSite v3 with all necessary configuration files.

4

Configuration

Edit the configuration files before starting:

config/.env
# Basic Configuration
APP_NAME=DeepSite v3
APP_ENV=local
APP_DEBUG=false
APP_URL=http://localhost:8080

# Database Configuration
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=deepsite
DB_USERNAME=deepsite_user
DB_PASSWORD=secure_password

# Redis Configuration
REDIS_HOST=redis
REDIS_PASSWORD=null
REDIS_PORT=6379

# Generate APP_KEY after first launch with:
# docker-compose exec app php artisan key:generate

Generate a new APP_KEY using: php artisan key:generate after installation.

5

Start DeepSite v3

Terminal Commands
# Start all services
docker-compose up -d

# Wait for initialization (2-5 minutes)
# Check status
docker-compose ps

# View logs (Ctrl+C to exit)
docker-compose logs -f

# Generate application key
docker-compose exec app php artisan key:generate

# Run database migrations
docker-compose exec app php artisan migrate

The system will be available at http://localhost:8080 after initialization completes.

6

Initial Setup

  1. Access http://localhost:8080 in your browser
  2. Create admin account with secure credentials
  3. Configure your first site settings
  4. Set up local backup directory (recommended: /path/to/backups)
  5. Complete security checklist in admin panel

Note: First-time setup may take several minutes as the system initializes all components.

7

Troubleshooting

Common Issues:

Port conflicts: Change port 8080 in docker-compose.yml if needed.

Database issues: Wait 2-3 minutes for MySQL initialization.

Key generation: Must run 'php artisan key:generate' after first launch.

Maintenance Commands
# Restart services
docker-compose restart

# Rebuild containers
docker-compose up -d --build

# Stop all containers
docker-compose stop

# Start stopped containers
docker-compose start

# Full reset (deletes all data)
docker-compose down -v

# Backup database
docker-compose exec mysql mysqldump -u deepsite_user -psecure_password deepsite > backup.sql

# Restore database
cat backup.sql | docker-compose exec -T mysql mysql -u deepsite_user -psecure_password deepsite