linux-image-manager/README.md

71 lines
3.3 KiB
Markdown
Raw Normal View History

2019-09-30 13:44:02 +02:00
# Core System
2019-10-01 08:10:18 +02:00
[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](./LICENSE.txt) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/6e66409513d7451b949afbf0373ba71f)](https://www.codacy.com/manual/KevinFrantz/core-system?utm_source=github.com&utm_medium=referral&utm_content=KevinFrantz/core-system&utm_campaign=Badge_Grade) [![Travis CI](https://travis-ci.org/KevinFrantz/core-system.svg?branch=master)](https://travis-ci.org/KevinFrantz/core-system)
2019-09-30 14:47:48 +02:00
2019-10-07 08:12:21 +02:00
This repository contains scripts to set up an working client system, maintain it and to save all important and configuration data on an USB stick. The data is stored encrypted with [EncFS](https://en.wikipedia.org/wiki/EncFS).
It's adapted to the needs of Kevin Veen-Birkenbach aka. Frantz. Feel free to modularize it and to adapt it to your needs.
![Empty Core System Screen](./.meta/core-system-screenshot.png)
<sub>*Core System* changes the wallpaper every day to the [Astronomy Picture of the Day](https://apod.nasa.gov/apod/). This wallpaper is from the 2019-10-07 and shows Jupiter with the shadow of his moon Io. </sub>
2019-09-30 14:47:48 +02:00
## Requirements
This script is optimized for a [Manjaro Linux](https://manjaro.org) with [GNOME desktop](https://www.gnome.org/?).
2019-10-07 08:12:21 +02:00
## System
2019-10-07 08:58:21 +02:00
### Key Bindings
The following *Core System* specific key bindings exist:
|Combination |Result |
|------------|-----------------|
|Ctrl+Alt+A |Opens Atom |
|Ctrl+Alt+E |Opens Eclipse |
|Ctrl+Alt+F |Opens Firefox |
|Ctrl+Alt+K |Opens KeePassXC |
|Ctrl+Alt+T |Opens a terminal |
2019-10-07 08:12:21 +02:00
### User Data
Right now the software expects that the *Core System Owner* has on all systems the same username. By executing the *import script* it automatic backups the application configuration data, ssh keys and other important data which is saved in well defined configuration files and folders.
2019-10-07 08:58:21 +02:00
#### Folders
2019-10-07 08:12:21 +02:00
Next to this the following specific folders exist:
##### $HOME/Documents/certificates/
Contains certificates to authenticate via [certificate based authentication](https://blog.couchbase.com/x-509-certificate-based-authentication/).
##### $HOME/Documents/recovery_codes/
Contains files with recovery_codes e.g. for [Two-factor authentication](https://en.wikipedia.org/wiki/Multi-factor_authentication).
##### $HOME/Documents/identity/
Contains files to prove the identity of the *Core System Owner* in physical live like passports.
##### $HOME/Documents/passwords/
Contains e.g the [KeePassXC](https://keepassxc.org/) database with all *Core System Owner* passwords.
2019-09-30 14:47:48 +02:00
## Functions
### System Setup
To setup the customized software on a system you have to execute:
```bash
bash ./scripts/system-setup.sh
```
### Import Data
To import configuration files from the system you have to execute:
```bash
bash ./scripts/import-data-from-system.sh
```
### Export Data
To export configuration files to the system you have to execute:
```bash
bash ./scripts/export-data-to-system.sh
```
### Unlock Data
2019-09-30 14:47:48 +02:00
To decrypt the data you have to execute:
```bash
bash ./scripts/unlock.sh
2019-09-30 14:47:48 +02:00
```
### Lock Data
2019-09-30 14:47:48 +02:00
To encrypt the data you have to execute:
```bash
bash ./scripts/lock.sh
```
### Change Data Password
To change the encryption password you have to type in:
```bash
encfsctl passwd .encrypted
2019-09-30 14:47:48 +02:00
```
2019-09-30 13:44:02 +02:00
## License
The ["GNU GENERAL PUBLIC LICENSE Version 3"](./LICENSE.txt) applies to this project.