https://github.com/ut-issl/issl-ubuntu-environment-setup

Reproducible shared Ubuntu environment for ISSL
https://github.com/ut-issl/issl-ubuntu-environment-setup

development-environment linux sw-team ubuntu

Last synced: 1 day ago
JSON representation

Reproducible shared Ubuntu environment for ISSL

• Host: GitHub
• URL: https://github.com/ut-issl/issl-ubuntu-environment-setup
• Owner: ut-issl
• License: apache-2.0
• Created: 2026-03-10T07:10:56.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-06-21T14:20:01.000Z (9 days ago)
• Last Synced: 2026-06-21T14:35:58.204Z (9 days ago)
• Topics: development-environment, linux, sw-team, ubuntu
• Language: Shell
• Homepage:
• Size: 375 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# issl-ubuntu-environment-setup

[![Ubuntu](https://img.shields.io/badge/Ubuntu-E95420.svg?style=flat&logo=ubuntu&logoColor=white)](https://ubuntu.com)

[![Built with Nix](https://img.shields.io/badge/Built_with_Nix-41439a.svg?style=flat&logo=nixos&logoColor=white)](https://nixos.org)

[![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg?style=flat)](#license)

[![prek](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/j178/prek/master/docs/assets/badge-v0.json)](https://github.com/j178/prek)

[![CI](https://github.com/ut-issl/issl-ubuntu-environment-setup/actions/workflows/ci.yaml/badge.svg)](https://github.com/ut-issl/issl-ubuntu-environment-setup/actions/workflows/ci.yaml)

[![Test](https://github.com/ut-issl/issl-ubuntu-environment-setup/actions/workflows/test.yaml/badge.svg)](https://github.com/ut-issl/issl-ubuntu-environment-setup/actions/workflows/test.yaml)

A repository for distributing a reproducible and maintainable shared Ubuntu environment for ISSL.

> [!WARNING]

> This repository is an early-stage prototype and is under active development.

> It may be made private or deleted without prior notice.

> It is provided as-is, without user support or compatibility guarantees.

> Use it at your own risk.

## How to Use

This repository can be used in two ways:

1. Create and maintain a personal Nix configuration repository with Home Manager

   that is designed to import this ISSL config from the start.

   - See [setup with a personal config repository](docs/11-setup-with-a-personal-config-repository.md).

2. Use the setup script provided by this repository.

   - See [script-based setup](docs/12-script-based-setup.md).

For more details, see the [User Guide](docs/10-user-guide.md).

## For Developers

See [Developer Guide](docs/90-developer-guide.md).

## License

Licensed under either of [MIT license](LICENSE-MIT) or [Apache License, Version 2.0](LICENSE-APACHE) at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this software

by you, as defined in the Apache-2.0 license, shall be dually licensed as above,

without any additional terms or conditions.