====Build VyOS 1.4 LTS on Debian 12====

===Base Debian Install

  * Install Debian 12 with just standard system utilities and SSH server, create root and standard user accounts during install.


==Install and Configure sudo==
Login as root then:
<code>
apt-get update
apt-get upgrade
apt-get install sudo
/usr/sbin/usermod -a -G sudo username
</code>

====Build VyOS 1.4====
https://docs.vyos.io/en/sagitta/contributing/build-vyos.html#build-native

==Install Docker==
<code>
sudo apt-get update
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg2 software-properties-common
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
sudo apt-get update
sudo apt-get install -y docker-ce
</code>

==Pull Docker Container for 1.4==
<code>
sudo docker pull vyos/vyos-build:sagitta
</code>
Note: if you are updating to a new release delete the old images then do the docker pull. To delete the old images <code>sudo docker system prune</code>

==Clone Source from Git for 1.4==
<code>
git clone -b sagitta --single-branch https://github.com/vyos/vyos-build
</code>
<code>
#Note: if you've done this already and are updating to a new release then 
sudo rm -rf vyos-build
</code>

==Build via Docker==
Note, change the version to the 1.4 release you want or to whatever is the current stable release
<code>
cd vyos-build
sudo docker build -t vyos/vyos-build:sagitta docker
sudo docker run --rm -it --privileged -v $(pwd):/vyos -w /vyos vyos/vyos-build:sagitta bash
cd vyos-build
sudo ./build-vyos-image iso --architecture amd64 --build-type release --version 1.4.0 --build-by "j.randomhacker@vyos.io"
</code>

CD into build folder then scp iso file to another host.
<code>
cd build
scp vyos.iso user@host:~
</code>

====Misc Notes====
To save VyOS config first save to system then save to file and scp it or save to sftp directly.
<code>
commit
save
save file
scp /config/saved.file user@remotehost:~
</code>
or
<code>
commit
save
save sftp://<user>:passwd>@<host>/<file>
</code>
or save scp the file from a remote host:
<code>
commit
save
(then from a different host)
scp vyosadmin@vyos:/config/saved.file ~
</code>

To restore
scp file to vyos then load file
<code>
scp save.file vyosadmin@vyos:/config/saved.file
(then on vyos host)
load /config/saved.file
commit
save
</code>
or load a config directly from a remote host
<code>
load sftp://<user>:passwd>@<host>/<file>
commit
save
</code>

To load new image:
<code>
scp vyos.1.4.iso vyosadmin@vyos:/tmp
</code>
then:
<code>
add system image /tmp/vyos1.4.iso
reboot
</code>
or
<code>
add system image https://some.remote.host.com/vyos1.4/x64/vyos1.4.iso
reboot
</code>

==Misc Docker Notes==
Docker seems to eat space. https://forums.docker.com/t/some-way-to-clean-up-identify-contents-of-var-lib-docker-overlay/30604/44

Clean with:
<code>
sudo docker system prune -a
</code>