Installation/installer-shell: Difference between revisions

From Snakeoil OS Reference
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
{{DISPLAYTITLE:Snakeoil OS Installer}}{{TopicInstallation|float:right}}Snakeoil OS 1.1.x (Blind Testing) is one of the best sounding operating system for audiophiles out there. However, the uncompromising sound quality also comes with uncompromising drawbacks!
{{DISPLAYTITLE:Snakeoil OS Installer}}{{TopicInstallation|float:right}}Snakeoil OS 1.1.x (Blind Testing) is one of the best sounding operating system for audiophiles out there. However, the uncompromising sound quality also comes with uncompromising drawbacks!


* Limited hardware support. The secret of SnakeoilOS audio quality is the custom built kernel. Every driver is built statically into the kernel. As such the kernel is not generic and only supports about 80% of computers out there.
*Limited hardware support. The secret of SnakeoilOS audio quality is the custom built kernel. Every driver is built statically into the kernel. As such the kernel is not generic and only supports about 80% of computers out there.
* The Blind Testing ISO is problematic with newer EFI motherboards and difficult for some people to get it working.
*The Blind Testing ISO is problematic with newer EFI motherboards and difficult for some people to get it working.
* Ubuntu 16.04 LTS is End Of Line (EOL). LTS is short for Long Term Support. Ubuntu 16.04 LTS is released sometime around 2016, and will be supported for 5 years. Meaning Ubuntu will officially stop support this version on 30th April 2021. That is the idea. In truth most package maintainers have already stopped supporting this release years ago. Some are even not supporting 18.04 LTS (EOL on 30th April 2023).
*Ubuntu 16.04 LTS is End Of Line (EOL). LTS is short for Long Term Support. Ubuntu 16.04 LTS is released sometime around 2016, and will be supported for 5 years. Meaning Ubuntu will officially stop support this version on 30th April 2021. That is the idea. In truth most package maintainers have already stopped supporting this release years ago. Some are even not supporting 18.04 LTS (EOL on 30th April 2023).


With LTS having a shorter supporting cycle than anticipated, maintaining a Snakeoil LiveCD is not feasible for the long term.
With LTS having a shorter supporting cycle than anticipated (2.5 years rather than the expected 5), maintaining a Snakeoil LiveCD is not feasible for the long term.


==The Evolution. Project Gear Isolation==
==The Evolution. Project Gear Isolation==
Snakeoil OS has to evolve again to stay relevant. The new release will now be de-coupled mostly from the underlying Operating System. This will address all the problems highlighted above. This is a game changer as Snakeoil OS Is now supported on any computers that support Ubuntu.
Snakeoil OS has to evolve again to stay relevant.
 
The new release will now be de-coupled mostly from the underlying Operating System. It will come in the form of an installer that should work for This will address all the problems highlighted above. This is a game changer as Snakeoil OS Is now supported on any computers that support Ubuntu.


==Supported Distributions==
==Supported Distributions==
Line 30: Line 32:


===Install Your Choice Operating System===
===Install Your Choice Operating System===
Follow the [[Installation/installer-shell#Supported Distributions|installation guide]] of your choice OS and install it on your computer. If prompted, '''<u>install the SSH server</u>'''.  
Follow the installation guide of your choice OS and install the OS first on your computer.  
 
If prompted during the installation, install the '''<u>SSH server</u>'''. This will make it easier to transfer the Snakeoil installer to your freshly installed machine.  


Note the following details during installation as you will need them later:
Note the following details during installation as you will need them later:


*The IP address of your computer
*The IP address of your computer
*The user login
*The user login account
*The user password
*The user password


===Install SSH===
===Install SSH Server===
If you haven't already, install SSH server, for Ubuntu systems, the command is:
You can still install a SSH server after installation. On Debian based systems (e.g. Ubuntu), the command to install OpenSSH server:
  apt install -y openssh-server
  apt install -y openssh-server


===Download the Snakeoil Installer===
===Download the Snakeoil Installer===
Now you need to transfer the Snakeoil Installer to this newly installed computer.  
Go to the [https://www.snakeoil-os.net/forums Snakeoil Forums] and look for the latest Snakeoil installer. You can download the installer from a machine and copy it to your freshly installed computer with tools like scp. Or download the installer directly using tools like wget.  


Go to the [https://www.snakeoil-os.net/forums Snakeoil Forums] and look for the latest Snakeoil installer
====Upload Installer To Your Snakeoil PC====
This requires a SSH server running on your Snakeoil PC.


here are many ways to skin a cat, here are two:
Use a tool like [https://winscp.net/eng/index.php WinSCP] for the file transfer. Follow their [https://winscp.net/eng/docs/task_upload guide] on how to upload files.


====Upload Installer to Music PC====
====Direct Download From The Snakeoil PC====
You can transfer the installer to your Snakeoil computer using tools like [https://winscp.net/eng/index.php WinSCP]. Folow their [https://winscp.net/eng/docs/task_upload guide] on how to upload files.
 
====Direct Download To Music PC====
From your computer (or via SSH), run the following command, and replace url_of_installer with actual URL.
From your computer (or via SSH), run the following command, and replace url_of_installer with actual URL.
  wget <url_of_installer>
  wget <url_of_installer>
Line 61: Line 63:


===Execute the Snakeoil Installer===
===Execute the Snakeoil Installer===
The installer will download additional packages from your distribution so ensure you have Internet connectivity before running this step. On your Snakeoil computer, go to the directory where you have placed the Snakeoil installer, and execute the installer like so:
The installer will download and install additional packages so ensure you have Internet connectivity before running this step.
 
On your Snakeoil computer, go to the directory where you have placed the Snakeoil installer, and execute the installer like so:
  sudo ./snakeoil-installer-1.2.0-x86_64.sh
  sudo ./snakeoil-installer-1.2.0-x86_64.sh
Remember to change the installer name accordingly. You should see something like the following:
Remember to change the installer name accordingly. You should see something like the following:
Line 67: Line 71:


===Reboot The Computer===
===Reboot The Computer===
You need to reboot the computer if this is your first install.
Reboot the computer if prompted to do so.


===Access The Snakeoil WebApp===
===Access The Snakeoil WebApp===
From another computer, start your web browser, and enter the IP address of your Snakeoil computer in the address bar.
From another computer, start your web browser, and enter the IP address of your Snakeoil computer in the address bar.
[[File:Tab dashboard.png|alt=WebApp|center|thumb|Snakeoil WebApp|800x800px]]
[[File:Tab dashboard.png|alt=WebApp|center|thumb|Snakeoil WebApp|800x800px]]
<br />{{ManualNavigation|[[Installation]]}}
 
== Post Installation ==
Some of the players will require additional configuration. Visit the [[players]] page for more information.{{ManualNavigation|[[Installation]]}}
[[Category:Installation]]
[[Category:Installation]]

Revision as of 11:24, 1 May 2021

Snakeoil OS 1.1.x (Blind Testing) is one of the best sounding operating system for audiophiles out there. However, the uncompromising sound quality also comes with uncompromising drawbacks!

  • Limited hardware support. The secret of SnakeoilOS audio quality is the custom built kernel. Every driver is built statically into the kernel. As such the kernel is not generic and only supports about 80% of computers out there.
  • The Blind Testing ISO is problematic with newer EFI motherboards and difficult for some people to get it working.
  • Ubuntu 16.04 LTS is End Of Line (EOL). LTS is short for Long Term Support. Ubuntu 16.04 LTS is released sometime around 2016, and will be supported for 5 years. Meaning Ubuntu will officially stop support this version on 30th April 2021. That is the idea. In truth most package maintainers have already stopped supporting this release years ago. Some are even not supporting 18.04 LTS (EOL on 30th April 2023).

With LTS having a shorter supporting cycle than anticipated (2.5 years rather than the expected 5), maintaining a Snakeoil LiveCD is not feasible for the long term.

The Evolution. Project Gear Isolation

Snakeoil OS has to evolve again to stay relevant.

The new release will now be de-coupled mostly from the underlying Operating System. It will come in the form of an installer that should work for This will address all the problems highlighted above. This is a game changer as Snakeoil OS Is now supported on any computers that support Ubuntu.

Supported Distributions

These are the officially supported distributions. Additional distributions (e.g. Fedora) can be added in the demand is there. Download the "Server" edition where possible as Snakeoil OS is designed to run headless. Not using a Graphical User Interface (GUI) conserves valuable resources and improve overall responsiveness of your PC.

Ubuntu

  • Down official ISO here. Older systems can try the Legacy edition here.
  • Follow the Installation Guide to install this Operating System

Raspberry Pi Raspbian

  • Download Raspberry Pi OS here.
  • 32 bit support only (armv7l)
  • Follow their guide on how to flash the OS.

You are almost good to go oOnce you installed the underlying Operating System.

Steps To Install Snakeoil

Follow these steps to run Snakeoil OS on your PC

Install Your Choice Operating System

Follow the installation guide of your choice OS and install the OS first on your computer.

If prompted during the installation, install the SSH server. This will make it easier to transfer the Snakeoil installer to your freshly installed machine.

Note the following details during installation as you will need them later:

  • The IP address of your computer
  • The user login account
  • The user password

Install SSH Server

You can still install a SSH server after installation. On Debian based systems (e.g. Ubuntu), the command to install OpenSSH server:

apt install -y openssh-server

Download the Snakeoil Installer

Go to the Snakeoil Forums and look for the latest Snakeoil installer. You can download the installer from a machine and copy it to your freshly installed computer with tools like scp. Or download the installer directly using tools like wget.

Upload Installer To Your Snakeoil PC

This requires a SSH server running on your Snakeoil PC.

Use a tool like WinSCP for the file transfer. Follow their guide on how to upload files.

Direct Download From The Snakeoil PC

From your computer (or via SSH), run the following command, and replace url_of_installer with actual URL.

wget <url_of_installer>

Execute the Snakeoil Installer

The installer will download and install additional packages so ensure you have Internet connectivity before running this step.

On your Snakeoil computer, go to the directory where you have placed the Snakeoil installer, and execute the installer like so:

sudo ./snakeoil-installer-1.2.0-x86_64.sh

Remember to change the installer name accordingly. You should see something like the following:

Running The Snakeoil Installer script.png

Reboot The Computer

Reboot the computer if prompted to do so.

Access The Snakeoil WebApp

From another computer, start your web browser, and enter the IP address of your Snakeoil computer in the address bar.

WebApp
Snakeoil WebApp

Post Installation

Some of the players will require additional configuration. Visit the players page for more information.

 Main   Installation