Differences

This shows you the differences between two versions of the page.

--- devdoc:documentation [2023/07/01 07:49]
abelbeck
+++ devdoc:documentation [2024/02/26 06:43] (current)
abelbeck [Linux Build System]
@@ Line 1: / Line 1: @@
 ====== Development Environment ======
-The AstLinux Development Environment (ADE) is maintained in a repository on GitHub using subversion (SVN) or GIT.
+The AstLinux Development Environment (ADE) is maintained in a repository on GitHub.
 AstLinux is cross-compiled, generating target images for x86_64 CPU architectures, using a custom maintained version of [[https://buildroot.org|Buildroot]].
@@ Line 16: / Line 16: @@
 Linux Build Systems known to work **(must be x86_64)**:
-  * Debian 11 - //(recommended)//
+  * Debian 11
+  * Debian 12 - //(recommended)//
 !!Tip ->!! Use a somewhat older LTS (Long Term Support) Linux distro in a VM, that will be the most compatible with our version of Buildroot.
@@ Line 22: / Line 23: @@
 !!Tip ->!! Use a "Minimal Install" of your Linux distro, dedicated to building AstLinux.
-!!Tip ->!! To run Debian 10 in a LXC container on Proxmox 6/7, you need to enable "Nesting" under "Options/Features", otherwise you'll end up getting "Permission denied" errors when starting several services (e.g. apache2, ntp). Creating a Flash Image does **not** work in a LXC container!
+===== Promox notes =====
+!!Tip ->!! To run Debian 10/11 in a LXC container on Proxmox 6/7/8, you need to enable "Nesting" under "Options/Features", otherwise you'll end up getting "Permission denied" errors when starting several services (e.g. apache2, ntp). Creating a Flash Image does **not** work in a LXC container (you need a "full" VM for this)!
+!!Tip ->!! There seems to be a problem when running the "Linux Build System" in Proxmox as __LXC container__ **AND** __on a ZFS filesystem__. If you get errors like this:
+  genext2fs: couldn't allocate a block (no free space)
+although there is plenty of free space. It doesn't happen when running the filesystem on LVM or LVM-thin.
 ===== Prerequisites =====
-To build Astlinux you first need to install some additional packages, depending on your Linux distribution:
+To build Astlinux you first need to install some additional packages:
 **[[.packages|Package lists]]**
@@ Line 43: / Line 51: @@
 !!Important ->!! You should **not be root**, login as a non-admin user.
 ===== Checking out the Source =====
-Now we will grab AstLinux via SVN:
+Now we will grab AstLinux via ''git'':
-  svn co https://github.com/astlinux-project/astlinux.git/trunk astlinux/trunk
- //("trunk" is the latest development branch)//
-**Explanation:**
- ''svn'' - name of subversion binary should not be root.
- ''co'' - short for "checkout", grab source from url:
- ''svn:...'' - URL of AstLinux SVN repository, an argument to co to specify the location of checkout
- ''astlinux/trunk'' - store the previous URL in a local directory on this machine in the "astlinux" directory
+  git clone https://github.com/astlinux-project/astlinux.git astlinux/trunk
-You should see a bunch of files scroll down your machine. Depending on the speed of your connection, this could take a few minutes or a few hours (hopefully just a few minutes - we want to start building)!
+You should see a bunch of files scroll down your machine. Depending on the speed of your connection, this could take a few seconds or a minute.
-Once the checkout process has completed, cd into astlinux/trunk to look around:
+Once the clone process has completed, cd into astlinux/trunk to look around:
   cd astlinux/trunk