v4ult / ubuntu

Shell scripts for automated Ubuntu server setup.

Ubuntu

This project contains a set of shell scripts for installing and configuring a fresh Ubuntu operating system. It is assumed that the base Ubuntu install is a server install and not a client install.

This project can serve as a prelude to the Rails Setup Project should you wish to have a bootstrapped Rails app running on a fresh Ubuntu install with a full server stack.

Table of Contents

• Features
• Requirements
• Setup
• Usage
• Versioning
• Code of Conduct
• Contributions
• License
• History
• Credits

Features

• A configurable shell script for applying default settings and installing necessary software packages.

Requirements

1. Ubuntu

Setup

Open a terminal window and execute one of the following setup sequences depending on your version preference:

Current Version (stable):

git clone https://github.com/bkuhlmann/ubuntu.git
cd ubuntu
git checkout 3.1.0

Master Version (unstable):

git clone https://github.com/bkuhlmann/ubuntu.git
cd ubuntu

Edit the setup.sh file and adjust the settings as you see fit, namely the following variables:

• SERVER_IP
• SERVER_HOSTNAME
• USER_LOGIN
• USER_PASS

You may want to tweak the *.sh files in the scripts folder as well.

Usage

1. ssh to your server or VM.
2. Switch to the root user.
3. Create the a /root/.ssh/authorized_keys file with your public key.
4. chmod -R 600 /root/.ssh.
5. mkdir /root/ubuntu.
6. Copy the files of this project to the /root/ubuntu folder. Example: scp -r - [email protected]:/root/ubuntu.
7. Run the /root/ubuntu/bin/run script in the root of this project.
8. Delete the /root/ubuntu folder.
9. Delete the /root/.ssh folder.

Versioning

Read Semantic Versioning for details. Briefly, it means:

• Major (X.y.z) - Incremented for any backwards incompatible public API changes.
• Minor (x.Y.z) - Incremented for new, backwards compatible, public API enhancements/fixes.
• Patch (x.y.Z) - Incremented for small, backwards compatible, bug fixes.

Code of Conduct

Please note that this project is released with a CODE OF CONDUCT. By participating in this project you agree to abide by its terms.

Contributions

Read CONTRIBUTING for details.

License

Copyright 2012 Alchemists. Read LICENSE for details.

History

Read CHANGES for details. Built with Bashsmith.

Credits

Developed by Brooke Kuhlmann at Alchemists.