mirror of
https://github.com/Dvorinka/Containr.git
synced 2026-10-28 15:51:26 +00:00
Tomas DvorakandDevin
060038cb6f
- Replace redis:7-alpine with Dragonfly (Redis-protocol compatible; go-redis client unchanged) in root, infra, and backend-dev compose files. Bounded defaults --proactor_threads/--maxmemory so it boots on small VPSs. - Frontend now defaults to same-origin API calls; nginx proxies /api/* to the backend (WebSocket-aware, docker DNS resolver for upstream re-resolution). Removes the baked localhost:8082 that broke installs reached by IP/domain. - /auth/bootstrap returns configured OAuth providers; the UI hides GitHub/Google buttons unless real credentials exist. Self-hosted stays email/password only - OAuth reserved for a future managed offering. - Sidecar ignores PLACEHOLDER_* OAuth credentials and trusts same-host origins dynamically (Origin host == request Host) so remote installs pass origin checks without config; cross-origin requests still rejected. - install.sh writes ENVIRONMENT=production; COOKIE_SECURE=false in production is now a startup warning instead of fatal (plain-HTTP installs). - Bootstrap failure surfaces an error notice instead of silently rendering the sign-in page. Authored By: TDvorak <[email protected]> Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
3.0 KiB
3.0 KiB
Containr Backend Setup
Quick Start
Prerequisites
- Go 1.21+
- PostgreSQL 12+
- Dragonfly or Redis-compatible cache (optional)
Environment Variables
Create a .env file or set these environment variables:
# Database
DATABASE_URL=postgres://containr:password@localhost:5432/containr?sslmode=disable
REDIS_URL=redis://localhost:6379
# Server
PORT=8080
ENVIRONMENT=development
# Security
JWT_SECRET=your-secret-key-change-in-production
# Frontend (for CORS)
FRONTEND_URL=http://localhost:3000
Database Setup
- Create PostgreSQL database:
CREATE DATABASE containr;
CREATE USER containr WITH PASSWORD 'password';
GRANT ALL PRIVILEGES ON DATABASE containr TO containr;
- Run migrations (handled automatically on server start)
Running the Server
# Build
go build -o bin/server cmd/server/main.go
# Run
./bin/server
The server will start on http://localhost:8080
API Endpoints
Health Check
GET /health- Server health status
Authentication
POST /api/v1/auth/login- User loginPOST /api/v1/auth/register- User registration
User Profile
GET /api/v1/user/profile- Get user profile (requires auth)PUT /api/v1/user/profile- Update user profile (requires auth)
Projects
GET /api/v1/projects- List user projects (requires auth)POST /api/v1/projects- Create project (requires auth)GET /api/v1/projects/:id- Get project details (requires auth)PUT /api/v1/projects/:id- Update project (requires auth)DELETE /api/v1/projects/:id- Delete project (requires auth)
Authentication
Include JWT token in Authorization header:
Authorization: Bearer <your-jwt-token>
Example Usage
- Register a user:
curl -X POST http://localhost:8080/api/v1/auth/register \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"password": "password123",
"name": "Test User"
}'
- Login:
curl -X POST http://localhost:8080/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"password": "password123"
}'
- Create a project (using token from login):
curl -X POST http://localhost:8080/api/v1/projects \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <token>" \
-d '{
"name": "My Project",
"description": "A test project"
}'
Development
Project Structure
cmd/server/ - Main application entry point
internal/
├── api/ - HTTP handlers and routes
├── config/ - Configuration management
├── database/ - Database connections and migrations
└── middleware/ - HTTP middleware
migrations_goose/ - Goose-managed migrations (single migration path)
Adding New Endpoints
- Create handler functions in
internal/api/ - Add routes in
internal/api/routes.go - Update database schema if needed in
migrations_goose/(goose format:-- +goose Up/Down)