Maintos

A maintainers' dashboard for all metaKGP projects deployed on the server.
Website · Request Feature / Report Bug

Table of Contents

• About The Project
• Development
• Deployment
• Contact
  • Maintainer(s)
  • creators(s)
• Additional documentation

About The Project

Maintos is a maintainer's dashboard which gives maintainers access to information and control on their projects, without requiring explicit access to the server. Maintainers of a project can start/stop the running containers/services, read logs for the project, as well as see and update environment variables.

(back to top)

Development

1. Clone this repository.
2. Backend:
   • Copy .env.template to .env and update the values as per Environment Variables.
   • For the backend to run, Docker must be installed and running.
   • Run the backend:

     cargo run

3. Frontend:
   • Set the environment variables in .env.local:
     • VITE_BACKEND_URL: URL of the backend
     • VITE_GH_OAUTH_CLIENT_ID: Client ID of the GitHub OAuth App.
   • Run the frontend:

     npm install
     npm run dev

Environment Variables

This project needs a GitHub OAuth app and a Personal Access Token of an admin of the GitHub org.

• GH_CLIENT_ID, GH_CLIENT_SECRET: Client ID and Client Secret for the GitHub OAuth application.
• GH_ORG_NAME: Name of the GitHub organisation
• GH_ORG_ADMIN_TOKEN: A GitHub PAT of an org admin
• JWT_SECRET: A secure string (for signing JWTs)
• DEPLOYMENTS_DIR: Absolute path to directory containing all the project git repos (deployed)
• SERVER_PORT: Port where the backend server listens to
• CORS_ALLOWED_ORIGINS: Frontend URLs

Deployment

[WIP]

Contact

📫 Metakgp -

Maintainer(s)

The currently active maintainer(s) of this project. See https://wiki.metakgp.org/w/Metakgp:Project_Maintainer.

• Harsh Khandeparkar
• Devansh Gupta

Additional documentation

• License
• Code of Conduct
• Security Policy
• Contribution Guidelines

(back to top)