Seamless Docker Swarm Backup & Migration Suite
Key Features • Quick Start • Documentation • Contributing • Support
HarborStacks is a modern, user-friendly web interface for deploying and managing Docker services through Portainer. It provides an intuitive installation wizard, real-time status updates, and comprehensive service management capabilities.
- Visual Service Installer: Step-by-step wizard for deploying Docker services
- Real-time Monitoring: Live status updates and progress tracking
- Dark Mode Support: Built-in theme switching capability
- Responsive Design: Optimized for desktop, tablet, and mobile devices
- Dynamic Form Generation: Automatic configuration forms based on service requirements
- Pre-flight Checks: Environment validation before deployment
- Error Recovery: Automatic retry options and detailed error messages
- API Integration: Full Portainer API support for service management
- Node.js 18 or higher
- Docker and Docker Swarm
- Portainer CE/EE installed
- Git
- Clone the repository:
git clone https://github.com/hipnologo/harborstacks.git
cd harborstacks- Install dependencies:
npm install
# or
yarn install
# or
pnpm install- Configure environment variables:
cp .env.example .env.local- Run the development server:
npm run dev
# or
yarn dev
# or
pnpm devOpen http://localhost:3000 to see the application.
HarborStacks/
├── app/ # Next.js app router pages
├── components/ # React components
│ ├── ui/ # Reusable UI components
│ ├── services/ # Service-related components
│ └── installers/ # Installation wizards
├── lib/ # Utilities and configurations
│ ├── api/ # API integration
│ ├── types/ # TypeScript types
│ └── utils/ # Helper functions
└── public/ # Static assets
NEXT_PUBLIC_PORTAINER_URL=https://your-portainer-instance
NEXT_PUBLIC_API_VERSION=2.0- Traefik & Portainer
- Chatwoot
- MinIO
- n8n
- PostgreSQL
- MongoDB
- Redis
- And more...
Detailed documentation is available in the docs directory:
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the GPL Version 3.0 - see the LICENSE file for details.
- Portainer for container management
- Docker for containerization
- Next.js for the framework
- Tailwind CSS for styling
- Shadcn/ui for UI components
Made with ❤️ by the HarborStacks Team