Unix PC Setup

An ansible playbook that creates a reproducable unix environment!

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Contributing
4. License
5. Contact
6. Acknowledgments

About The Project

This project is about creating a reproducable environment with the help of an ansible playbook and the nix package manager for all unix based operating systems.

(back to top)

Built With

• 

(back to top)

Getting Started

To get started you need to have a pc with a unix operating system. Some tasks in the playbook are specific to the ubuntu distribution of linux. If you are using another distribution of linux or another operating system you can submit a pull request of the same task with the modified when condition based on your operating system.

Prerequisites

All of the commands below were executed on ubuntu 22.04. Execute them based on your specific operating system and using your preferred package manager.

• First update and upgrade your package manager

  sudo apt update && sudo apt upgrade

• Make sure you have installed git and curl

  sudo apt install git curl -y

• Install the nix package manager (multi-user install recommended)

  sh <(curl -L https://nixos.org/nix/install) --daemon

• Make sure you have installed Ansible

  sudo apt install software-properties-common
  sudo add-apt-repository --yes --update ppa:ansible/ansible
  sudo apt install ansible

Installation

1. Clone the repo

   git clone https://github.com/inikolaou/pc-setup.git

2. Install ZSH first

   ansible-playbook pc-setup/run.yml -K --tags "zsh"

3. Log out of the system and log back in
4. Execute the remaining tasks based on your preferences by using specific tags

   ansible-playbook pc-setup/run.yml -K # you can specify no tag if you want to download all the software I have included in the tasks folder
   ansible-playbook pc-setup/run.yml -K --tags "dev-env" # this is the tag you should use if you're coming from my .dotfiles repository

5. Reboot your system

(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 GNU GPL-3.0 License. See LICENSE for more information.

(back to top)

Contact

Project Link: https://github.com/inikolaou/pc-setup

(back to top)

Acknowledgments

• Getting Started With Ansible
• Nix Package Manager

(back to top)