Coder Social home page Coder Social logo

abyss's Introduction

Abyss

The main purpose of the project is to install a fresh Void Linux system with Full Disk Encryption. It will not install anything you don't need (see below) and will leave the system almost like if you would install it by yourself when following official installation instructions.

To keep things simple, the following choices were made:

  • Only UEFI systems are supported (yet?).
  • Only glibc is supported (yet?).
  • An entire disk is required for the installation.
  • Only Btrfs on LUKS is supported.
  • Only GRUB bootloader is supported.

After installation you'll end up with a system which you can log in into but there's nothing which can start a graphical session. The only optional package that will be installed is fish-shell which is a runtime dependency and can be removed right away.

Bugs

Right now GRUB is always targetings x86_64-efi systems which prevents installation on non x86-64 machines. This is a bug and will be fixed soonj.

Usage

  • Boot from USB drive and install runtime dependencies.
  • Clone the repository.
    • Alternatively, download latest sources from here.
  • Ajust configuration in the config.fish.
    • Be sure to change SUPER_STRONG_PASSWORD to an actual strong LUSK/user password.
    • If you don't have SSD, then remove ssd from MOUNT_OPTS and disable EXT_TRIM.
  • Run ./main.fish after cd'ing into the project root.

Extended Setup

You can also choose to do an extended installation which includes few additional steps:

  • Installs and enables a Cron daemon (cronie).
  • Installs and enables a NTP daemon (openntpd).
  • Installs and enables a syslog daemon (socklog).
  • Enables iptables (with shipped rules).
  • Enables dhcpcd.
  • Enables some sysctl rules for kernel and networking stack hardening.
  • Enables TRIM job for SSD.

Each of the steps are optional and can be disabled/enabled in config.fish.

Runtime Dependencies

Before installing the system, install these packages:

  • fish-shell - shell to run the script.
  • gptfdisk - GPT-compatible partition utility.

After Installation

You should be able to boot into the system and log in with the user which you specified in the configuration file. Now it's time to setup Xorg or Wayland.

For a quick Xorg installation and configuration you can borrow bootstrap script from my dotfiles.

Alternatives

Abyss was inspired by a great voidvault project and provides a subset of it's functionality. Check it out if Abyss doesn't meet your requirements.

abyss's People

Contributors

rabbitinspace avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.