Skip to content

MattDGTL/shipyard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Shipyard

Shipyard is a sleek, responsive iFrame widget designed for Homarr, your customizable dashboard for homelab management. With Shipyard, you can effortlessly control your Docker containers from Homarr, giving you a smooth and user-friendly way to manage your infrastructure.

Features

  • Container Management: Start, stop, and monitor your Docker containers directly from the Homarr dashboard.

  • Responsive Design: Adapts to any screen size, ensuring a seamless experience.

  • Real-time Status Indicators: Easily distinguish container states:Running: Green check mark (✅)

  • Stopped: Red cross (❌)

  • Other statuses: Purple dot (🟣)

  • Dark & Light Theme Support: Automatically adapts to your system theme.

  • Sorting: Quickly sort containers by name or status for efficient management.

Installation

Pull

git clone https://github.com/MattDGTL/shipyard.git

CD into the main directory

cd shipyard/

In the directory where your Dockerfile, app.py, and templates folder are located, run the following commands:

docker build -t shipyard .

Run the Docker container:

docker run -d -p 8765:8765 -v /var/run/docker.sock:/var/run/docker.sock --name shipyard shipyard

Add a Homarr iFrame, insert URL (http://$DOCKERIP:8765)

Usage

Once installed and running, Shipyard will appear on your Homarr dashboard. You can:

  • View all Docker containers and their statuses.

  • Start or stop containers with a single click.

  • Sort containers for quick management.

Customization

For further customization, modify the index.html file in the repository.

Contributing

We welcome contributions! If you find any issues or have ideas for improvement, feel free to open a pull request or issue.

License

Licensed under the MIT License. See the LICENSE file for more details.

About

A small Docker management widget for Homarr.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published