{"id":28066856,"url":"https://github.com/jasonlovesdoggo/velo","last_synced_at":"2025-10-11T01:20:37.037Z","repository":{"id":291316548,"uuid":"977222422","full_name":"JasonLovesDoggo/Velo","owner":"JasonLovesDoggo","description":"Docker Swarm PaaS that just works - deploy, monitor, scale, automate.","archived":false,"fork":false,"pushed_at":"2025-06-13T22:38:34.000Z","size":203,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-26T05:37:18.174Z","etag":null,"topics":["coolify","deployment","devops","heroku","self-host","self-hostable","self-hosted","selfhosting","vps","vps-deployment","vps-setup","vps-ubuntu"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JasonLovesDoggo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-03T17:46:06.000Z","updated_at":"2025-06-24T08:51:50.000Z","dependencies_parsed_at":"2025-05-12T15:55:02.855Z","dependency_job_id":"1a99a0bf-e253-4c0e-b567-3509e9c9618e","html_url":"https://github.com/JasonLovesDoggo/Velo","commit_stats":null,"previous_names":["jasonlovesdoggo/velo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/JasonLovesDoggo/Velo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JasonLovesDoggo%2FVelo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JasonLovesDoggo%2FVelo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JasonLovesDoggo%2FVelo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JasonLovesDoggo%2FVelo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JasonLovesDoggo","download_url":"https://codeload.github.com/JasonLovesDoggo/Velo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JasonLovesDoggo%2FVelo/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262188397,"owners_count":23272341,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["coolify","deployment","devops","heroku","self-host","self-hostable","self-hosted","selfhosting","vps","vps-deployment","vps-setup","vps-ubuntu"],"created_at":"2025-05-12T15:54:59.087Z","updated_at":"2025-10-11T01:20:31.991Z","avatar_url":"https://github.com/JasonLovesDoggo.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Velo\n\nA lightweight, self-hostable deployment platform built on Docker Swarm. PaaS simplicity without the complexity.\n\n## What is Velo?\n\nVelo transforms Docker Swarm into a user-friendly deployment platform for small teams and homelab enthusiasts. Deploy services through a clean web interface, powerful CLI, or API - all while maintaining the simplicity and reliability of Docker Swarm.\n\n## Quick Start\n\n### Automated Installation\n```bash\ncurl -sSL https://raw.githubusercontent.com/jasonlovesdoggo/velo/main/install.sh | bash\n```\n\n### Manual Installation\n```bash\n# Clone and build\ngit clone https://github.com/jasonlovesdoggo/velo.git\ncd velo\nmake build\n\n# Start manager node\n./bin/velo --manager\n\n# Access web interface at http://localhost:8080\n# Default login: admin / admin\n```\n\n## Features\n\n- **Web Interface**: Deploy and manage services through a modern web UI\n- **CLI Tools**: Full-featured command line interface for automation\n- **Authentication**: Built-in user management and session handling\n- **Docker Swarm**: Leverages proven container orchestration\n- **State Management**: Persistent service configuration and deployment history\n\n## Usage\n\n### Deploy via Web UI\n1. Navigate to `http://localhost:8080`\n2. Login with default credentials (admin/admin)\n3. Use the Deploy Service form to create new deployments\n\n### Deploy via CLI\n```bash\n# Deploy a service\n./bin/veloctl deploy --name nginx --image nginx:latest --replicas 2\n\n# Check status\n./bin/veloctl status nginx\n\n# Scale service\n./bin/veloctl scale nginx --replicas 5\n```\n\n### Deploy via API\n```bash\ncurl -X POST http://localhost:37355/api/deploy \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"serviceName\":\"nginx\",\"image\":\"nginx:latest\",\"replicas\":1}'\n```\n\n## Architecture\n\n- **Server** (`velo`): Main application with manager and worker modes\n- **CLI** (`veloctl`): Client interface for deployments and management\n- **Web Interface**: Built-in HTTP server for browser-based management\n- **gRPC API**: High-performance API for programmatic access\n\n## Requirements\n\n- Docker 20.10+ with Swarm mode enabled\n- Go 1.24+ (for building from source)\n- Linux/macOS (Windows support coming soon)\n\n## Development\n\n```bash\n# Install dependencies\nmake deps\n\n# Run tests\nmake test\n\n# Start development server\nmake dev\n\n# View all available commands\nmake help\n```\n\n## Status\n\nVelo is production-ready for small to medium deployments. Active development continues with new features being added regularly. See [roadmap](docs/roadmap.md) for planned features.\n\n## License\n\nAGPL-3.[AGPLv3](LICENSE)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasonlovesdoggo%2Fvelo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjasonlovesdoggo%2Fvelo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasonlovesdoggo%2Fvelo/lists"}