Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/utkuufuk/ubuntu-on-steroids
Developer setup & configuration guide for Ubuntu
https://github.com/utkuufuk/ubuntu-on-steroids
dotfiles linux neovim tilix ubuntu vim vscode zsh zshrc
Last synced: about 2 months ago
JSON representation
Developer setup & configuration guide for Ubuntu
- Host: GitHub
- URL: https://github.com/utkuufuk/ubuntu-on-steroids
- Owner: utkuufuk
- Created: 2018-10-11T11:34:59.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-05-16T18:18:45.000Z (over 2 years ago)
- Last Synced: 2024-04-10T09:51:41.205Z (6 months ago)
- Topics: dotfiles, linux, neovim, tilix, ubuntu, vim, vscode, zsh, zshrc
- Language: Shell
- Homepage:
- Size: 110 KB
- Stars: 121
- Watchers: 7
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome - utkuufuk/ubuntu-on-steroids - Developer setup & configuration guide for Ubuntu (Shell)
README
# Ubuntu on Steroids
### Table of Contents
1. [Common Dependencies](#common-dependencies)
2. [Common Tools & Drivers](#common-tools--drivers)
3. [Git & Github](#git--github)
4. [Theme](#theme)
5. [Neovim](#neovim)
6. [Terminal & Shell](#terminal--shell)
7. [Python](#python)
8. [Go](#go)
9. [Rust](#rust)
10. [Node.js](#nodejs)
11. [Laravel](#laravel)
12. [Visual Studio Code](#visual-studio-code)
13. [Other Tools](#other-tools)
14. [Docker](#docker)
15. [MySQL](#mysql)
16. [DigitalOcean](#digitalocean)
### Common Dependencies
* `sudo apt install net-tools`
* `sudo apt install curl`
* `sudo apt install python3-pip`
### Common Tools & Drivers
#### Nvidia Driver
> *Software & Updates > Additional Drivers*
#### KeePass
``` sh
sudo apt install keepass2
```
#### OBS
``` sh
sudo add-apt-repository ppa:obsproject/obs-studio
sudo apt install obs-studio
```
#### Ubuntu Software
* Dropbox
* Spotify
* GIMP
### Git & Github
#### Install Git & Configure SSH
1. `sudo apt install git`
2. [Generate SSH Key](https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/) (or reuse an existing key)
3. [Add SSH Key to Github Account](https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/) (skip if reusing an existing key)
``` sh
# tip: get lines of code in a particular language within a Git repository
git ls-files | grep '\.py$' | xargs wc -l
```
### Theme
#### Fonts
1. [Hack](https://github.com/source-foundry/Hack/releases/download/v3.003/Hack-v3.003-ttf.zip)
2. [Courier Prime Code](https://www.fontsquirrel.com/fonts/courier-prime-code)
3. [Input](http://input.fontbureau.com/download/index.html?size=15&language=python&theme=monokai&family=InputMono&width=300&weight=400&line-height=1.3&a=ss&g=ss&i=serifs_round&l=serifs_round&zero=slash&asterisk=height&braces=0&preset=default&customize=please)
4. Fira Code
``` sh
sudo apt install fonts-firacode
```
5. Source Code Pro
``` sh
git clone --depth 1 --branch release https://github.com/adobe-fonts/source-code-pro.git ~/.fonts/adobe-fonts/source-code-pro
fc-cache -f -v ~/.fonts/adobe-fonts/source-code-pro
```
#### Gnome Theme
* `sudo add-apt-repository -u ppa:snwh/ppa`
* `sudo apt update`
* `sudo apt install paper-icon-theme`
* `sudo apt install gnome-tweak-tool`
* *Tweaks > Appearance > Applications > Adwaita-dark*
* *Tweaks > Appearance > Icons > Paper*
* *Tweaks > Fonts > [your_favourite_font]*
#### Desktop Slideshow
> *Shotwell Photo Manager > Select Pictures > File > Set as Desktop Slideshow*
### Neovim
1. [Install Neovim](https://github.com/neovim/neovim)
1. `sudo apt install neovim`
2. `curl -o ~/.config/nvim/init.vim --create-dirs https://raw.githubusercontent.com/utkuufuk/ubuntu-on-steroids/master/init.vim`
2. [Install Vim-Plug](https://github.com/junegunn/vim-plug)
> `curl -fLo ~/.local/share/nvim/site/autoload/plug.vim --create-dirs https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim`
3. Activate plugins by using the command `:PlugInstall` in `vim ~/.config/nvim/init.vim`
### Terminal & Shell
#### [Tilix](https://github.com/gnunn1/tilix)
1. Install Tilix
> `sudo apt install tilix`
2. Install Dracula Theme
```sh
curl -o ~/.config/tilix/schemes/Dracula.json --create-dirs https://raw.githubusercontent.com/dracula/tilix/master/Dracula.json
```
3. Customize Tilix Appearance
* *Preferences > Appearance > Window Style > Disable CSD && hide toolbar*
* *Preferences > Appearance > Terminal Title Style > None*
* *Preferences > Profile > Color > Color scheme > Dracula*
4. Configure Tilix Keyboard Shortcuts
* *Preferences > Shortcuts > Replace **`Switch to next session`** shortcut with **`Alt+Right`***
* *Preferences > Shortcuts > Replace **`Switch to previous session`** shortcut with **`Alt+Left`***
* *Preferences > Shortcuts > Replace **`Paste`** shortcut with **`Ctrl+V`***
* *Preferences > Shortcuts > Replace **`Resize the terminal down`** shortcut with **`Shift+Ctrl+Down`***
* *Preferences > Shortcuts > Replace **`Resize the terminal up`** shortcut with **`Shift+Ctrl+Up`***
* *Preferences > Shortcuts > Replace **`Resize the terminal right`** shortcut with **`Shift+Ctrl+Right`***
* *Preferences > Shortcuts > Replace **`Resize the terminal left`** shortcut with **`Shift+Ctrl+Left`***
5. Configure System Keyboard Shortcuts
* *Keyboard Shortcuts > Remove Default Action for **`Ctrl+Alt+T`***
* *Keyboard Shortcuts > Bind **`Ctrl+Alt+T`** to Custom Shortcut for Launching Tilix*
* *Keyboard Shortcuts > Disable Shortcut for **`Hide all normal windows`***
#### [Zsh](https://github.com/robbyrussell/oh-my-zsh/wiki/Installing-ZSH)
1. Install Zsh
* `sudo apt install zsh`
* `chsh -s $(which zsh)`
* `gnome-session-quit`
* *Login*
* `echo $SHELL`
2. [Oh My Zsh](https://github.com/robbyrussell/oh-my-zsh)
* `sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"`
3. [Spaceship Prompt](https://github.com/denysdovhan/spaceship-prompt)
* `git clone https://github.com/denysdovhan/spaceship-prompt.git "$ZSH_CUSTOM/themes/spaceship-prompt"`
* `ln -s "$ZSH_CUSTOM/themes/spaceship-prompt/spaceship.zsh-theme" "$ZSH_CUSTOM/themes/spaceship.zsh-theme"`
4. [Zsh Autosuggestions](https://github.com/zsh-users/zsh-autosuggestions)
* `git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions`
* `echo "bindkey '^ ' autosuggest-accept" >> $ZSH_CUSTOM/autosuggestion-settings.zsh`
* `source $ZSH_CUSTOM/autosuggestion-settings.zsh`
5. [Zsh Syntax Highlighting](https://github.com/zsh-users/zsh-syntax-highlighting)
* `git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting`
6. Configure `.zshrc`
* `curl -o ~/.zshrc https://raw.githubusercontent.com/utkuufuk/ubuntu-on-steroids/master/.zshrc`
* `source ~/.zshrc`
### Python
#### Install Pyenv
```sh
curl https://pyenv.run | bash
# init pyenv (see .zshrc)
source ~/.zshrc
```
#### Install Build Dependencies
```sh
sudo apt update && sudo apt install -y make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev \
libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev python-openssl git
```
#### Install Desired Releases
```sh
pyenv install 3.8.3
pyenv install 3.7.7
pyenv local 3.8.3 3.7.7
```
#### Install Poetry
```sh
curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python
source ~/.poetry/env
# new project
poetry init --no-interaction
poetry install
# run a Python session inside the virtual environment
poetry run python
# add & update a dependency
poetry add google-api-python-client
poetry update google-api-python-client
poetry add google-api-python-client^2.0 # upgrade to major release
```
### Go
```sh
sudo add-apt-repository ppa:longsleep/golang-backports
sudo apt update
sudo apt install golang-go
```
### Rust
```sh
curl https://sh.rustup.rs -sSf | sh
source $HOME/.cargo/env
```
### Node.js
#### Install NVM
Note that the version number may differ:
``` sh
# you might want to change the version
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.37.2/install.sh | bash
```
#### Install Node.js
```sh
# list available versions
nvm ls-remote
# install desired version(s)
nvm install x.y.z
# use desired node version
nvm use x.y.z
# update npm
npm install npm@latest -g
```
#### Configure
``` sh
npm config set init.author.name
npm config set init.author.email
```
### Laravel
#### Install PHP 7.3
```sh
sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt install \
php7.3 \
php7.3-common \
php7.3-mysql \
php7.3-xml \
php7.3-xmlrpc \
php7.3-curl \
php7.3-gd \
php7.3-imagick \
php7.3-cli \
php7.3-dev \
php7.3-imap \
php7.3-mbstring \
php7.3-opcache \
php7.3-soap \
php7.3-zip \
php7.3-gmp \
php7.3-intl -y
```
#### Install Composer
``` sh
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/home/utku/.local/bin --filename=composer
```
#### Install Laravel
``` sh
composer global require "laravel/installer"
```
#### Install XDebug
1. Clone the [XDebug repo.](https://github.com/xdebug/xdebug)
2. From within the repo dir, run the following commands:
``` sh
phpize
./configure --enable-xdebug
make clean
make
sudo make install
```
3. Add the following lines into your `php.ini`. (You can locate your `php.ini` by running the `php --ini` command)
``` sh
zend_extension="xdebug.so"
[XDebug]
xdebug.remote_enable = 1
xdebug.remote_autostart = 1
```
4. Verify that XDebug is successfuly installed by running the following command (it should match):
``` sh
php -v | grep "Xdebug"
```
### Visual Studio Code
1. [Download the .deb package](https://code.visualstudio.com/docs/?dv=linux64_deb)
2. Download Extensions
- Appearance
* Overnight (Slumber) *or* Night Owl
* Material Icon Theme
- Editor
* Vim
* TabNine
* EditorConfig for VS Code
- Remote Development
* Remote - SSH
* Remote - SSH: Editing Configuration Files
* Remote - SSH: Explorer
- Web Development
* REST Client
* Auto Rename Tag
* Live Server
* GraphQL
- Git
* GitLens
- JavaScript & TypeScript
* Prettier
* ESLint (`npm install -g eslint`)
* ES7 React/Redux/GraphQL/React-Native snippets
* vscode-sql-template-literal
- PHP
* PHP Debug
* PHP DocBlocker
* PHP Intelephense
* php cs fixer
* Larevel Blade Snippets
- Go
* Go
- Python
* Python
* AREPL for python
* autoDocstring
- Rust
* Rust
- Other
* Docker
* Create Files & Folders: On The Go
3. Copy the [settings file](vscode.settings.json) contents into `settings.json`
4. Copy the [keybindings file](vscode.keybindings.json) contents into `keybindings.json`
### Other Tools
* [Peek](https://github.com/phw/peek)
```sh
sudo add-apt-repository ppa:peek-developers/stable
sudo apt install peek
```
* [ag](https://github.com/ggreer/the_silver_searcher) & [sack](https://github.com/sampson-chen/sack)
``` sh
# 1. install ag
sudo apt install silversearcher-ag
# 2. install sack
git clone https://github.com/sampson-chen/sack.git && \
cd sack && \
chmod +x install_sack.sh && \
./install_sack.sh && \
cd .. && \
rm -rf sack
```
* [fd](https://github.com/sharkdp/fd) — `sudo apt install fd-find`
* [bat](https://github.com/sharkdp/bat) — `sudo apt install bat`
* [exa](https://github.com/ogham/exa) — `cargo install exa`
* [icdiff](https://www.jefftk.com/icdiff) — `sudo apt install icdiff`
### Docker
``` sh
# 1. remove any older versions
sudo apt purge docker lxc-docker docker-engine docker.io
# 2. install prerequisites
sudo apt install apt-transport-https ca-certificates software-properties-common
# 3. import official GPG key & verify signature
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add
# 4. add docker respository
sudo add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
# 5. install docker
sudo apt install docker-ce
# 6. verify service status
sudo systemctl status docker
# 7. create docker group & add your user
sudo groupadd docker
sudo usermod -aG docker $USER
```
> Log out and login back.
``` sh
# 8. verify that you can run this command without 'sudo'
docker run hello-world
# 9. install docker-compose 1.24.0 (better check newer versions)
sudo curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
# 10. apply executable permission
sudo chmod +x /usr/local/bin/docker-compose
```
See [cheatsheet](./docker.md) for more info.
### MySQL
#### Download MySQL Docker Image
```sh
docker pull mysql:
```
#### Start MySQL Container
``` sh
# publish default port, provide a root password and start mysql
docker run --name -p 3306:3306 -e MYSQL_ROOT_PASSWORD= mysql:
# you can provide optional config params like max-allowed-packet
docker run --name -p 3306:3306 -it -e MYSQL_ROOT_PASSWORD= mysql: --max-allowed-packet=67108864
```
#### Connect to MySQL Server from within the Container
1. **Run the MySQL Client**
``` sh
# check randomly generated password
docker logs 2>&1 | grep GENERATED
# run the MySQL client within the MySQL Server container
docker exec -it mysql -uroot -p
```
When prompted, paste the generated password obtained from the previous step.
2. **Reset Root Password**
``` sh
ALTER USER 'root'@'localhost' IDENTIFIED BY '';
```
#### Connect via Client
``` sh
# install client
sudo apt install mysql-client
# connect
mysql -h HOST -P PORT_NUMBER -u USERNAME -p
```
#### Backup & Restore
Backup & restore a particular database while MySQL container is running:
``` sh
# backup
docker exec mysqldump \
-u --password= > .sql
# restore
cat .sql | docker exec -i mysql \
-u --password=
# backup & compress
docker exec mysqldump \
-u --password= | gzip -c > .sql.gz
# decompress & restore
gzip -d -c .sql.gz | docker exec -i mysql \
-u --password=
```
See [cheatsheet](https://gist.github.com/bradtraversy/c831baaad44343cc945e76c2e30927b3) for more info.
### DigitalOcean
1. Follow the [Initial Server Setup](https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-18-04) guide.
2. Append public SSH keys of each client machine into the `~/.ssh/authorized_keys` file in droplet.