diff --git a/docs/installation/linux.md b/docs/installation/linux.md index 2606969dfa..802dab4b43 100644 --- a/docs/installation/linux.md +++ b/docs/installation/linux.md @@ -2,54 +2,67 @@ Package installation instructions ================================= Supports Ubuntu 14.04, CentOS 7.1, and OS X 10.11. +All packages are available on our GitHub [releases][] page. -Once the package is installed, `powershell` will be in your path, -ready to be launched from a terminal. It will read -`~/.powershell/profile.ps1` for your user profile, and -`/opt/microsoft/powershell/Microsoft.PowerShell_profile.ps1` for -the host profile. +Once the package is installed, `powershell` will be in your path, ready to be launched from a terminal. -Similarly, it will search `~/.powershell/Modules` and -`/opt/microsoft/powershell/Modules` for user and system modules. +* User profiles will be read from `~/.config/powershell/profile.ps1`. +* User modules will be read from `~/.local/share/powershell/Modules` +* PSReadLine history will be recorded to `~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt` +* System profiles will be read from `/opt/microsoft/powershell/profile.ps1`. +* System modules will be read from `/opt/microsoft/powershell/Modules` -To place PowerShell in your path, a symlink to the -`/opt/microsoft/powershell/powershell` executable is placed at -`/usr/bin/powershell`. +The profiles respect PowerShell's per-host configuration, so the default host-specific profiles exists at `Microsoft.PowerShell_profile.ps1` in the same locations. + +On Linux and OS X, the [XDG Base Directory Specification][xdg-bds] is respected. + +> Note that to place PowerShell in your path, the packages create a symlink from `/usr/bin/powershell` to the `/opt/microsoft/powershell/powershell` executable. + +[releases]: https://github.com/PowerShell/PowerShell/releases/latest +[xdg-bds]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html Ubuntu 14.04 ============ -Using a stock Ubuntu 14.04 image, download the -`powershell_0.5.0-1_amd64.deb` file, and then execute the following: +Using [Ubuntu 14.04][], download the Debian package `powershell_6.0.0-alpha.7-1_amd64.deb` from the [releases][] page onto the Ubuntu machine. + +Then execute the following in the terminal: ```sh sudo apt-get install libunwind8 libicu52 -sudo dpkg -i powershell_0.5.0-1_amd64.deb +sudo dpkg -i powershell_6.0.0-alpha.7-1_amd64.deb ``` -CentOS 7.1 -========== +> Please note that that Ubuntu 16.04 is not yet supported, but coming soon! -Using a stock CentOS 7.1 image, download the -`powershell-0.5.0-1.x86_64.rpm` file, and then execute the following: +[Ubuntu 14.04]: http://releases.ubuntu.com/14.04/ + +CentOS 7 +======== + +Using [CentOS 7][], download the RPM package `powershell-6.0.0_alpha.7-1.x86_64.rpm` from the [releases][] page onto the CentOS machine. + +Then execute the following in the terminal: ```sh -sudo yum install powershell-0.5.0-1.x86_64.rpm +sudo yum install powershell-6.0.0_alpha.7-1.x86_64.rpm ``` +> Please note that we have not tested this package on Red Hat Enterprise Linux. + +[CentOS 7]: https://www.centos.org/download/ + OS X 10.11 ========== -Using an OS X 10.11 machine, download the `powershell-0.5.0.pkg` file, -double-click it, and follow the prompts. Or install it from the -terminal: +Using OS X 10.11, download the PKG package `powershell-6.0.0-alpha.7.pkg` from the [releases][] page onto the OS X machine. + +Either double-click the file and follow the prompts, or install it from the terminal: ```sh -sudo installer -pkg powershell-0.5.0.pkg -target / +sudo installer -pkg powershell-6.0.0-alpha.7.pkg -target / ``` -Note that because OS X is a derivation of BSD, instead of `/opt`, the -prefix used is `/usr/local`; thus, `powershell` lives at -`/usr/local/microsoft/powershell`, and the symlink is placed at -`/usr/local/bin/powershell`. This affects the system modules and -profile as well. +> Note that because OS X is a derivation of BSD, instead of `/opt`, the prefix used is `/usr/local`. +> Thus, `powershell` lives at `/usr/local/microsoft/powershell`, and the symlink is placed at `/usr/local/bin/powershell`. +> This affects the system modules and profiles as well.