Skip to content

Metratrj/Dock-N-Roll

Repository files navigation

Dock 'n' Roll

Dock 'n' Roll is a minimal Docker management tool written in PHP. It provides a simple web interface to view and manage Docker containers and images.

About The Project

This project was created to provide a lightweight and easy-to-use alternative to more complex Docker management tools. It is designed to be simple to set up and use, and it provides a clean and intuitive user interface.

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

  • Docker
  • PHP 8.2 or higher
  • Composer
  • Redis

Installation

  1. Clone the repo
    git clone https://github.com/metratrj/dock-n-roll.git
  2. Install PHP dependencies
    composer install
  3. Install NPM dependencies
    npm install
  4. Start the application
    docker-compose up -d
  5. Run the database migrations
    # (No migrations yet)
  6. Run the crawler to index your Docker containers and images
    php bin/crawler.php

Usage

Once the application is running, you can access it in your web browser at http://localhost:8080.

The main dashboard provides an overview of your Docker environment, including the number of running containers, images, and volumes.

You can view a list of all your containers and images by clicking on the corresponding links in the navigation menu. From there, you can view the details of a specific container or image, and you can perform actions such as starting, stopping, and deleting containers.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published