m1ngsama/automa
1
0
Fork 0
mirror of https://oauth2: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@github.com/m1ngsama/automa.git synced 2026-05-10 19:11:07 +08:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
35 commits 6 branches 1 tag 7 MiB
Shell 100%
Find a file
m1ngsama e5542de818 polish: CLI UX overhaul and rich .env.example metadata 
CLI improvements:
- Unicode status indicators (✔ ✘ ▶ ● ○ ⚠) and braille spinners
- Animated spinner for docker pull/up operations
- Project metadata parsed from .env.example (@name, @desc, @url, @port, @note)
- Descriptions shown in list, deploy selection, and status views
- Auto-generate passwords for secret fields (PASSWORD/TOKEN/AUTHKEY)
- Confirmation prompt before deploy with project summary
- Post-deploy access URL hint based on @port metadata
- Divider lines for visual section separation
- Helpful error messages with suggested commands
- Command aliases: ls, st, ps, down, log, configure
- Bash 3.2 compatible (no associative arrays)

.env.example enrichment:
- All projects now have @name, @desc, @url, @port metadata headers
- Inline field descriptions shown as context during interactive config
- Tailscale: @note hints for profile-based DERP deployment
- Structured comments group related settings visually

Installer:
- Prerequisite check with per-tool status (✔/✘)
- Quieter git operations
- Cleaner post-install instructions
2026-04-15 10:15:43 +08:00
filesuite polish: CLI UX overhaul and rich .env.example metadata 2026-04-15 10:15:43 +08:00
forgejo polish: CLI UX overhaul and rich .env.example metadata 2026-04-15 10:15:43 +08:00
minecraft polish: CLI UX overhaul and rich .env.example metadata 2026-04-15 10:15:43 +08:00
nextcloud polish: CLI UX overhaul and rich .env.example metadata 2026-04-15 10:15:43 +08:00
tailscale polish: CLI UX overhaul and rich .env.example metadata 2026-04-15 10:15:43 +08:00
teamspeak polish: CLI UX overhaul and rich .env.example metadata 2026-04-15 10:15:43 +08:00
uptime-kuma polish: CLI UX overhaul and rich .env.example metadata 2026-04-15 10:15:43 +08:00
.gitignore refactor: restructure as self-contained project dirs with interactive CLI 2026-04-15 09:54:23 +08:00
automa polish: CLI UX overhaul and rich .env.example metadata 2026-04-15 10:15:43 +08:00
install.sh polish: CLI UX overhaul and rich .env.example metadata 2026-04-15 10:15:43 +08:00
LICENSE chore: add project infrastructure files 2025-12-02 10:00:00 +08:00
README.md improve: best-practice configs for all projects, CLI UX overhaul 2026-04-15 10:02:41 +08:00

README.md

automa

Self-hosted Docker Compose project deployer. Interactive CLI for quick deployment.

Quick start

curl -fsSL https://raw.githubusercontent.com/m1ngsama/automa/main/install.sh | bash
cd ~/automa
./automa deploy

Usage

./automa deploy                      # interactive project selection
./automa deploy forgejo filesuite    # deploy specific projects
./automa status                      # check all project status
./automa logs forgejo                # follow logs
./automa stop forgejo                # stop a project
./automa update nextcloud            # pull latest images & recreate
./automa config tailscale            # reconfigure .env
./automa list                        # list available projects

Projects

Project Description
forgejo Self-hosted Git (Gitea fork)
uptime-kuma Uptime monitoring dashboard
tailscale Tailscale client + DERP relay server (profiles)
filesuite Cloudreve cloud storage + qBittorrent
minecraft Fabric Minecraft server
teamspeak TeamSpeak voice server
nextcloud Nextcloud with MariaDB + Redis

Structure

Each project is a self-contained directory:

project-name/
├── compose.yaml      # Docker Compose definition
├── .env.example      # Template — comments shown during setup
└── .env              # Your config (gitignored, created by CLI)

License

MIT