Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
meefik authored Feb 27, 2017
1 parent 6a3f57c commit 08464a5
Showing 1 changed file with 20 additions and 7 deletions.
27 changes: 20 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
Linux Deploy
============

Copyright (C) 2012-2016 Anton Skshidlevsky, [GPLv3](http://opensource.org/licenses/gpl-3.0.html)
Copyright (C) 2012-2017 Anton Skshidlevsky, [GPLv3](http://opensource.org/licenses/gpl-3.0.html)

This application is open source software for quick and easy installation of the operating system (OS) GNU/Linux on your Android device.

The application creates a disk image on a flash card, mounts it and installs an OS distribution. Applications of the new system are run in a chroot environment and working together with the Android platform. All changes made on the device are reversible, i.e. the application and components can be removed completely. Installation of a distribution is done by downloading files from official mirrors online over the internet. The application requires superuser rights (ROOT).

The program supports multi language interface. You can manage the process of installing the OS, and after installation, you can start and stop services of the new system (there is support for running your scripts) through the UI. The installation process is reported as text in the main application window. During the installation, the program will adjust the environment, which includes the base system, SSH server, VNC server and desktop environment. The program interface can also manage SSH and VNC settings.

Installing a new operating system takes about 30 minutes. The recommended minimum size of a disk image is 1024 MB (with LXDE), and without a GUI - 512 MB. When you install Linux on the flash card with the FAT32 file system, the image size should not exceed 4095 MB! After the initial setup the default password for SSH and VNC is changeme. The password can be changed through standard OS tools.
Installing a new operating system takes about 30 minutes. The recommended minimum size of a disk image is 1024 MB (with LXDE), and without a GUI - 512 MB. When you install Linux on the flash card with the FAT32 file system, the image size should not exceed 4095 MB! After the initial setup the password for SSH and VNC generated automatically. The password can be changed through "Properties -> User password" or standard OS tools (passwd, vncpasswd).

#### Features: ####
#### Features:
* Supported distributions: Debian, Ubuntu, Kali Linux, Arch Linux, Fedora, CentOS, Gentoo, openSUSE, Slackware, RootFS (tgz, tbz2, txz)
* Installation type: image file, directory, disk partition, RAM
* Supported file systems: ext2, ext3, ext4
Expand All @@ -20,12 +20,25 @@ Installing a new operating system takes about 30 minutes. The recommended minimu
* Desktop environment: XTerm, LXDE, Xfce, MATE, other (manual configuration)
* Supported languages: multilingual interface

#### Install ####
#### Install
You can install the app from:
* GitHub: <https://github.com/meefik/linuxdeploy/releases>
* Google Play: <https://play.google.com/store/apps/details?id=ru.meefik.linuxdeploy>

#### Performance ####
#### FAQ
> Do not work update operating environment or errors appear in debug mode: "Permission denied", "Socket operation on non-socket" or other.
Install compatible [BusyBox](https://github.com/meefik/busybox/releases) in /system/xbin, add path /system/xbin in "Settings -> PATH variable", update the operating environment "Settings -> Update ENV". Before upgrading the environment, it is desirable restart the device. After that, the container options must be selected "Properties -> File system -> Auto" and "Propetries -> Image size (MB) -> 2000", because "busybox mke2fs" is not supperted an option "-t" to specify type of file system and not supperted image greater 2 GB. Now you can start a new installation "Menu -> Install".

> Making an image on sdcard return an error "Read-only file system".
If you are using SuperSU utility you need to uncheck "mount namespace separation" in SuperSU settings. See [documentation](https://su.chainfire.eu/#how-mount).

> Installing an application on Google Play fails with the message "Unknown error code during application installation: -24".
You need to remove the application directory: /data/data/ru.meefik.linuxdeploy

#### Performance
SD card read / write speed (10 class) on Android (Samsung Galaxy S II) for file systems vfat, ext2, ext4:
* **vfat**: read speed 14.1 MB/s; write speed 12.0 MB/s
* **ext2**: read speed 14.9 MB/s; write speed 3.9 MB/s
Expand All @@ -41,8 +54,8 @@ Installation time and use space on disk (Debian wheezy/armhf on Samsung Galaxy S
* **GNOME** ~ 0:55 / 1.3 GB
* **KDE** ~ 1:20 / 1.3 GB

#### Source code ####
#### Source code
Source code: <https://github.com/meefik/linuxdeploy>. The project is written using Android Studio.

#### Donations ####
#### Donations
<http://meefik.github.io/donate>

0 comments on commit 08464a5

Please sign in to comment.