Skip to content
This repository has been archived by the owner on Sep 18, 2023. It is now read-only.

gohypergiant/firefly

Repository files navigation

NOTICE: This repository has been archived and development moved to gohypergiant/charts


Logo

Hyperdrive Notebooks

Deploy and manage Jupyterlab and Hyperdrive Community Edition locally, on AWS, or to any Kubernetes cluster
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

Home

Built With

(back to top)

Getting Started

Local deployment

Prerequisites

Installation

  1. Install prerequisites.
  2. Clone the repo
    git clone https://github.com/gohypergiant/firefly.git
  3. Run the build script
    build.sh
  4. The stack takes approximately 2 minutes to install. After that, navigate to http://localhost:8090/ to access Firefly.

(back to top)

Pre-existing cluster (Helm)

Prerequisites

Installation

  1. Install prerequisites.

  2. Add the helm repo

    helm repo add firefly https://gohypergiant.github.io/firefly
  3. Install the helm chart with helm install firefly firefly/firefly. Be sure to include your customized values file.

  4. The stack takes approximately 2 minutes to install. After that, navigate to http://localhost:8090/ or the ingress host specified in your values file to access Firefly.

(back to top)

AWS CloudFormation

Prerequisites

  • An AWS account
  • A route53 zone
  • An SSH keypair added to AWS
  • An IAM user with permissions to deploy and configure EC2 instances and DNS via Cloudformation

Installation

See the user manual for instructions

(back to top)

Usage

Firefly/Hyperdrive Notebooks is designed to make the already amazing Zero2Jupyterhub even easier to launch and manage while providing enhancements via the Community Edition of Hyperdrive. It can be deployed locally, onto an existing Kubernetes cluster, or via Cloudformation on AWS.

After launching your deployment, navigate to the signup page to create the first user, named firefly

firefly is the default admin and first authorized user, but does not have a password until the user is registered for the first time. This allows you to set your own password when the stack is launched for the first time. Your password must be 10 characters or longer.

(back to top)

After registering the first user, you can now log in and authorize or manage additional users

(back to top)

Or you can administer the Hub itself as an admin user

(back to top)

Roadmap

  • GPU support
  • Hyperdrive Community Edition
  • Additional profiles
  • RBAC

See the open issues for a full list of proposed features (and known issues).

(back to top)

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

(back to top)

License

Distributed under the Apache-2 License. See LICENSE for more information.

(back to top)

Acknowledgments

(back to top)

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published