Code Monkey home page Code Monkey logo

linuxdeploy's Introduction

Linux Deploy

Copyright (C) 2012-2019 Anton Skshidlevsky, GPLv3

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 or a directory on a flash card or uses a partition or RAM, 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 can run better with 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 15 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).

The app is available for download in Google Play and GitHub.

Get it on Google Play Get it on Github

Features

  • Bootstrap: Alpine, Arch, CentOS, Debian, Fedora, Kali, Slackware, Ubuntu, Docker or from rootfs.tar
  • Installation type: image file, directory, disk partition, RAM
  • Supported file systems: ext2, ext3, ext4
  • Supported architectures: arm, arm64, x86, x86_64, emulation mode (ARM ~ x86)
  • Control interface: CLI, SSH, VNC, X11, Framebuffer
  • Desktop environment: XTerm, LXDE, Xfce, MATE, other (manual configuration)
  • Supported languages: multilingual interface

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 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.

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
  • ext4: read speed 14.9 MB/s; write speed 16.6 MB/s
  • ext2 (loop): read speed 17.0 MB/s; write speed 7.4 MB/s
  • ext4 (loop): read speed 17.2 MB/s; write speed 8.8 MB/s

Installation time and use space on disk (Debian wheezy/armhf on Samsung Galaxy S II):

  • Without GUI ~ 0:12 / 260 MB
  • XTerm ~ 0:14 / 290 MB
  • LXDE ~ 0:19 / 450 MB
  • XFCE ~ 0:20 / 495 MB
  • GNOME ~ 0:55 / 1.3 GB
  • KDE ~ 1:20 / 1.3 GB

Links

Source code:

Donations:

linuxdeploy's People

Contributors

meefik avatar iscle avatar elxreno avatar vergedx avatar zaoqi avatar rkkoszewski avatar deicpro avatar kjy00302 avatar khimaros avatar caponk12 avatar shalokshalom avatar m0rtadelo avatar phoenix09 avatar kieaer avatar fafriat avatar fogapod avatar bernardogiordano 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.