Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Install script to change your Mac Mini or other Mac or Linux and maybe Windows into a fully self-controlled personal cloud station.

Notifications You must be signed in to change notification settings

andriesbron/MiniCloud

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

20 Commits

Repository files navigation

πŸ–₯️ MiniCloud: Portainer Setup And Docker Stack Launcher

A simple, self-contained system to deploy and manage your favorite services using Docker and Portainer.

  • Developed for Mac Mini
  • Attention Not for production use, solemn for private local hosting in a safe network.

With this setup, you maintain full control over your services, keep everything isolated, and can deploy or update stacks with just one script.

πŸ‘·β€β™‚οΈ Todo

  • Setup Caddy
  • Setup Portal page

🌟 Features

  • Self-control & Simplicity
    Launch and manage your services locally without relying on external orchestrators or cloud providers.
    All stacks live on your own machine, giving you full visibility and control.

  • Portainer Integration
    Deploys services in a way fully compatible with Portainer.
    You can monitor, manage, and configure your stacks visually through the Portainer dashboard.

  • Persistent data to local disc Volumes mounted to host, outside docker registry.

  • Automatic setup and deploy All stacks deploy automatically using ./deploy.sh and attach to your existing Docker networks.

  • Reusable Templates
    Docker Compose templates are preprocessed before deployment, replacing paths and environment variables automatically.

πŸš€ Currently Deployed Stacks

Emoji Stack Description
πŸ“ filebrowser Web-based file manager
πŸ™ gitea Self-hosted Git service
πŸ““ jupyter Interactive data science notebooks
πŸ₯— mealie Personal recipe manager
☁️ nextcloud Private cloud storage & collaboration
🧰 redis High-performance key-value store
πŸ“ sagemath Open-source mathematics system

⚑ Quick Start

  1. Clone this repository
git clone <your-repo-url>
cd <your-repo>
  1. Run the deploy script
chmod +x deploy.sh
./deploy.sh
  1. Open Portainer Visit http://localhost:9000 (or your configured Portainer instance) to view and manage your stacks.

πŸ”’ Why This Setup?

ou stay in control:

  • No external dependencies beyond Docker.
  • Easy to extend or customize
    • Add new stack templates in library/stack-templates.
  • Compatible with Portainer, so you can visually manage networks, volumes, and containers.

πŸ“‚ Structure

.
β”œβ”€β”€ deploy.sh # Launches all stacks
β”œβ”€β”€ stacks/ # Processed YAML files for deployment
└── library/stack-templates/ # Stack templates

πŸ’‘ Tips

  • Customize .tpl files for your environment paths or secrets.
  • Use Portainer to monitor logs, resource usage, and update stacks seamlessly.

πŸš€ Next Steps

  • Add new stack templates for additional services
  • Integrate automatic backups for Nextcloud, Mealie, and Gitea.
  • Expand monitoring with Portainer alerts or Prometheus/Grafana.

πŸ™‹β€β™‚οΈ Pull Requests?

Sure!

About

Install script to change your Mac Mini or other Mac or Linux and maybe Windows into a fully self-controlled personal cloud station.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /