Skip to content

Latest commit

 

History

History
121 lines (65 loc) · 4.89 KB

README.md

File metadata and controls

121 lines (65 loc) · 4.89 KB

Exopods: Container Management and Logging

Made with 🧡 by Aesthisia

New age web based container management & logging platform for developers.

Exopods is a platform for containerization and management of applications. This logging platform aims to simplify the process of managing and monitoring Docker containers and their logs.

Current version rc-1.0.02 is a alpha release, You might encounter some issues. We have already listed the know issues if you are facing any other issues, feel free to raise an issue in this repo.

Container Details

Features

  • Easy management of Docker containers.
  • Real-time logging for Docker containers.
  • Search and filter logs by container, image, and time.
  • Automatic rotation and archival of logs.
  • Multiple methods for integrating logs into external systems such as Elasticsearch or Logstash.

Getting Started

To get started with exopods platform, you need to have a basic understanding of Docker and its containers. You also need to have Docker installed on your system. Note: Currently exopods support only linux/amd64 based os images.

Prerequisites

  • Docker
  • Docker Compose(optional)

Installation

❗❗ Important: Make sure to map the port correctly.

Deploy on docker host

Exopod application will be running on internal port 8001 inside the container, you can change external port by passing the -p <external-port>:8001, internal port can not be changed.

sudo docker run -d -v /var/run/docker.sock:/var/run/docker.sock --name exopods -p 8001:8001 aesthisia/exopods:rc-1.0.02

Then your app will be running on HOST:8001, navigate to browser, the use public ip or localhost to access exopods. e.g. http://xx.xx.xx.xx:8001

Deploy on docker-compose

Clone the repo or copy & create a docker-compose.yaml & paste the content from the file present in this repo. Also make sure to change the HOST_URL in docker-compose.yml.

sudo docker-compose up -d

Navigate to the host url & you will be redirected to the login page. Also make sure desired port is open & not being blocked by your firewall. Default username is admin & password exopods

Configuration

Parameter Description Default
-e PASSWORD Setup a custom password exopods

Usage

The logging platform provides an intuitive web interface for managing and monitoring Docker containers and their logs. You can perform the following tasks:

  • View a list of all containers and their status.
  • Start, stop, and restart containers(To be added)
  • View logs for a specific container in real-time.
  • Search and filter logs by container, image, and time.(To be added)

To check the logs:

You can click on little file icon on the container list page or you can check the logs by clicking View Logs in container detail page.

Version

This is an Alpha release, rc-1.0.02 available on Dockerhub.

Security & Privacy

Exopod is a secure & closed system & it run on your environment, it doesn't require any backend or external resources. We strongly respect your privacy & we do not collect any logs or information about host. Your data stays with in your environment.

Image Scanning

Container image scanning has been already done & we are updating required versions with each release.

Docker Resources

Here are some resources to help you learn more about Docker:

Known Issues

Some of the known issue & temporary fix:

  • long container names can look out of the box.

If you are facing any other issues, please raise a issue request or join our Discord

Links

Discord: https://discord.gg/dhHZAvMvvB

Linkedin: https://www.linkedin.com/company/aesthisia

Website: https://aesthisia.com/

Github: https://github.com/Aesthisia

Dockerhub: https://hub.docker.com/repository/docker/aesthisia/exopods/general