https://github.com/tprasadtp/ubuntu-post-install
Effortless, Flexible and Simple Post Install Script for Ubuntu, Linux Mint, Debian & their derivatives
https://github.com/tprasadtp/ubuntu-post-install
debian-post-install fresh-installs linux-mint mint-post-install post-installation setup-script ubuntu ubuntu-installation ubuntu-post-install
Last synced: 5 months ago
JSON representation
Effortless, Flexible and Simple Post Install Script for Ubuntu, Linux Mint, Debian & their derivatives
- Host: GitHub
- URL: https://github.com/tprasadtp/ubuntu-post-install
- Owner: tprasadtp
- License: gpl-3.0
- Created: 2017-01-29T20:40:56.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-11-03T17:25:16.000Z (over 1 year ago)
- Last Synced: 2024-08-13T07:16:02.219Z (8 months ago)
- Topics: debian-post-install, fresh-installs, linux-mint, mint-post-install, post-installation, setup-script, ubuntu, ubuntu-installation, ubuntu-post-install
- Language: Shell
- Homepage: https://ae.prasadt.com
- Size: 30.5 MB
- Stars: 82
- Watchers: 5
- Forks: 32
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
- jimsghstars - tprasadtp/ubuntu-post-install - Effortless, Flexible and Simple Post Install Script for Ubuntu, Linux Mint, Debian & their derivatives (Shell)
README
# Ubuntu / Debian Post Installation Script
Effortless way to setup your fresh Ubuntu, Linux Mint and Debian installation.
[![build][build-badge]][build-link]
![website-deploy-badge]
[![version][version]][changelog]
[![license][gpl-badge]][license]
## How to use this
### 1. Get the script
#### Using latest stable version (Recommended)
```console
wget https://github.com/tprasadtp/ubuntu-post-install/releases/latest/download/after-effects -O after-effects
chmod +x ./after-effects
```#### Using latest master branch
```console
wget https://raw.githubusercontent.com/tprasadtp/ubuntu-post-install/master/after-effects -O after-effects
chmod +x ./after-effects
```### 2. Setup your YAML configuration file
Setup YAML file to suit your needs. Change PPAs, add or delete packages to list etc.
Please see [Configuration](https://ae.prasadt.com/configuration/) & [Tasks](https://ae.prasadt.com/tasks/).### 3. Run the script
Run the script as **root**.
Sample configuration can be found in `config` directory.
```console
chmod +x after-effects
sudo ./after-effects
```## See in Action
## FAQ & Documentation
See /docs or visit [docs][docs]
## Supported Distributions
[](https://www.ubuntu.com/desktop)
[](https://kubuntu.org/)
[](https://lubuntu.net/)
[](https://xubuntu.net/)
[](https://ubuntu-mate.org/)
[](https://ubuntubudgie.org/)
[](https://ubuntustudio.org/)
[](https://www.linuxmint.com/)
[](https://www.debian.org/)
[](https://elementary.io/)For a complete list of supported distributions [click here](https://ae.prasadt.com/faq/distros/).
## Features
- [Install packages](https://ae.prasadt.com/tasks/#install-apt-packages)
- [Add repositories](https://ae.prasadt.com/tasks/#add-repositories)
- [Remove pre installed](https://ae.prasadt.com/tasks/#purge-unwanted-packages)
- [Add PPAs](https://ae.prasadt.com/tasks/#add-personal-package-archives-ppa)
- [Install deb packages](https://ae.prasadt.com/tasks/#install-debian-package-archives-deb-files)
- [Install static binaries](https://ae.prasadt.com/tasks/#install-static-binaries)
- [Install snap packages](https://ae.prasadt.com/tasks/#installing-snap-packages)Also handles adding several tweaks and fixes necessary to add repositories and PPAs, supports completely non-interactive mode, so that you can let it run while you have moaar ☕
## Supported External repositories
| Name | Key | Packages
| ----------------------- | ----------------- | ---
| [Brave Browser][]* | brave_browser | brave-browser
| Docker | docker | docker-ce, docker-ce-rootless-extras, docker-ce-cli
| [Element.io][element]* | element_io | element-desktop
| [GitHub - CLI][] | github | gh
| [Google - Bazel][]* | bazel | bazel
| Google - Chrome* | chrome | google-chrome-stable, google-chrome-beta
| Google - Cloud SDK* | googlecloud | google-cloud-sdk, kubectl, google-cloud-sdk-minikube
| [Google - gVisor][] | gvisor | runsc
| Hashicorp* | hashicorp | terraform, consul, nomad, vault, boundary, waypoint
| Mendeley desktop* | mendeley | mendeleydesktop
| Microsoft - Azure CLI* | azurecli | azure-cli
| Microsoft - Edge* | edge | microsoft-edge-dev
| Microsoft - Skype* | skype | skypeforlinux
| Microsoft - VSCode | vscode | code, code-insiders, code-exploration
| [Miniconda][]* | miniconda | conda
| NeuroDebian* | neurodebian | https://neuro.debian.net/
| [Podman][] (via OBS)* | podman | podman, buildah
| ProtonVPN Client* | protonvpn | protonvpn
| ROS | ros |
| ROS2 | ros2 |
| Signal* | signal | signal-desktop
| Slack Desktop* | slack | slack-desktop
| Spotify Client* | spotify | spotify-client
| Sublime Text Editor* | sublimetext | sublime-text
| Vivaldi* | vivaldi | vivaldi-stable
| Wine HQ* | winehq | winehq-stable, winehq-staging
| [Ubuntu - Universe][] | ubuntu_universe |
| [Ubuntu - Multiverse][] | ubuntu_multiverse |
| [Ubuntu - Restricted][] | ubuntu_restricted |
| [Debian - contrib][] | debian_contrib |
| [Debian - non-free][]** | debian_nonfree |> **Note**
- `*` Only amd64/x86_64 is supported. ARM CPUs like Raspberry Pi/Nvidia Tegra are not
supported.
- `**` Debain non free is not supported on Debian Bookworm due to DEB-822 and inclusion of
non free drivers by default.## Issues & Help
- Please check [FAQ][FAQ] & [known issues][known-issues].
- Please include the log file and terminal output while opening an issue.## Contributing & Forks
See [Contributing and forks](/CONTRIBUTING.md)
## Alternatives
- [snwh/ubuntu-post-install](https://github.com/snwh/ubuntu-post-install): Has few features like setting up dotfiles, but has limited config options and requires shell to be interactive. Only few external repositories are supported.
- [Ansible](https://ansible.com) : Requires python on your system. Much more deteministic and better idempotency. There are plenty of roles and collections available on ansible-galaxy. But it adds more complexity and you have to write your own playbooks.[FAQ]: https://ae.prasadt.com/faq/dependencies/
[docs]: https://ae.prasadt.com/
[known-issues]: https://ae.prasadt.com/faq/errors/
[changelog]: https://ae.prasadt.com/changelog/[build-badge]: https://github.com/tprasadtp/ubuntu-post-install/workflows/build/badge.svg
[build-link]: https://github.com/tprasadtp/ubuntu-post-install/actions?query=workflow%3Abuild
[release-ci-badge]: https://github.com/tprasadtp/ubuntu-post-install/workflows/release/badge.svg
[release-ci-link]: https://github.com/tprasadtp/ubuntu-post-install/actions?query=workflow%3Arelease[docs-ci-badge]: https://github.com/tprasadtp/ubuntu-post-install/workflows/docs/badge.svg
[docs-ci-link]: https://github.com/tprasadtp/ubuntu-post-install/actions?query=workflow%3Adocs[netlify-badge]: https://api.netlify.com/api/v1/badges/887c3d5c-5203-46b9-a31d-67cada282f36/deploy-status
[netlify]: https://app.netlify.com/sites/ubuntu-post-install/deploys[website-deploy-badge]:https://img.shields.io/github/deployments/tprasadtp/ubuntu-post-install/production?label=docs&logo=vercel
[version]: https://img.shields.io/github/v/release/tprasadtp/ubuntu-post-install?label=version
[gpl-badge]: https://img.shields.io/badge/License-GPLv3-ff69b4
[license]: https://github.com/tprasadtp/ubuntu-post-install/blob/master/LICENSE[Brave Browser]: https://brave.com/linux/
[element]: https://element.io
[GitHub - CLI]: https://cli.github.com
[Google - gVisor]: https://gvisor.dev
[Miniconda]: https://www.anaconda.com/blog/rpm-and-debian-repositories-for-miniconda
[Podman]: https://podman.io
[Google - Bazel]: https://bazel.build
[Ubuntu - Universe]: https://help.ubuntu.com/community/Repositories/Ubuntu
[Ubuntu - Restricted]: https://help.ubuntu.com/community/Repositories/Ubuntu
[Ubuntu - Multiverse]: https://help.ubuntu.com/community/Repositories/Ubuntu
[Debian - contrib]: https://www.debian.org/doc/debian-policy/ch-archive#s-contrib
[Debian - non-free]: https://www.debian.org/doc/debian-policy/ch-archive#s-non-free