Describe the pull request

Implements embedded PostgreSQL database support using fergusstrange/embedded-postgres. Eliminates external database dependency for development and small deployments.

Link to the issue: n/a

Implementation

• New package: internal/embeddedpg manages PostgreSQL lifecycle (start/stop)
• CLI flag: --embedded-postgres on gogs web command
• Auto-configuration: Sets postgres connection to localhost:15432 with credentials gogs/gogs
• Initialization order: Calls conf.Init() and conf.InitLogging() before launching to ensure WorkDir() is available

Key decisions

• Port 15432: Avoids conflicts with standard PostgreSQL installations
• DataPath only: Simplified config; library handles runtime/binaries paths internally
• Defer shutdown: Ensures graceful cleanup on exit
• Storage: <work-dir>/data/local-postgres

Usage

gogs web --embedded-postgres

First run downloads PostgreSQL 18.0 binaries (~50-60s). Subsequent starts are instant.

Checklist

• I agree to follow the Code of Conduct by submitting this pull request.
• I have read and acknowledge the Contributing guide.
• I have added test cases to cover the new code or have provided the test plan.
• I have added an entry to CHANGELOG.

Test plan

1. Run gogs web --embedded-postgres
2. Verify PostgreSQL 18.0 starts on port 15432
3. Verify web server becomes available
4. Stop server (Ctrl+C) and verify clean shutdown logs
5. Restart to confirm data persistence

Unit tests verify initialization and shutdown without active database.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.