freeshard-run-and-operate

Orchestrate Shard Core FastAPI deployment and Docker Compose stack operations.

47|2|Updated Feb 11, 2025
One-click install
npx skills add https://github.com/FreeshardBase/freeshard --skill freeshard-run-and-operate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: freeshard-run-and-operate
Source: https://github.com/FreeshardBase/freeshard/tree/main/.claude/skills/freeshard-run-and-operate
Command: npx skills add https://github.com/FreeshardBase/freeshard --skill freeshard-run-and-operate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies the complex lifecycle of managing a Shard, the core application of the Freeshard personal cloud, by providing clear operational procedures for deployment, backup, and maintenance.

Core Features & Use Cases

  • Deployment Orchestration: Manage both local development environments and full production Docker Compose stacks.
  • Operational Lifecycle: Handle critical tasks like device pairing, backup/restore operations, and disk space management.
  • Use Case: Use this Skill to troubleshoot a deployment issue, perform a manual backup of your shard data, or verify the status of your self-hosted instance.

Quick Start

Use the freeshard-run-and-operate skill to start the full local stack by running the docker compose up command in your terminal.

Frequently Asked Questions about freeshard-run-and-operate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a FastAPI application with Docker Compose and Traefik for my personal cloud?

To deploy a FastAPI application with Docker Compose and Traefik, use this Skill to orchestrate the full production stack, configure the Traefik reverse proxy, and integrate Let's Encrypt SSL certificates for secure personal cloud management.

Can I manage rclone backups for my self-hosted Docker instances?

Yes, you can manage rclone backups for your self-hosted Docker instances. The Skill facilitates rclone-based backup management and restore operations, ensuring persistent state data is securely backed up and recoverable.

What is the best way to monitor disk space on a self-hosted personal cloud server?

The best way to monitor disk space on a self-hosted personal cloud server is using this Skill's operational lifecycle features. It handles disk space monitoring for your Docker Compose stack to prevent storage shortages.

Does this approach support device pairing for a FastAPI personal cloud environment?

Yes, this approach supports device pairing for a FastAPI personal cloud environment. The Skill explicitly handles device pairing tasks, allowing new hardware to connect and synchronize with your Shard Core application instance.

How do I start a local development environment for a FastAPI Docker Compose stack?

To start a local development environment for a FastAPI Docker Compose stack, use this Skill to run the docker compose up command in your terminal, managing both local development and full production deployments.

Why does my Traefik reverse proxy configuration fail when managing persistent state in Docker?

Traefik reverse proxy configuration failures when managing persistent state in Docker often stem from incorrect SSL integration or orchestration issues; use this Skill to troubleshoot deployment problems and validate your Traefik and Let's Encrypt setup.