maxmustermann/PowerShell
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Merge pull request #1539 from PowerShell/raghushantha-linuxinstall

Browse source 
Better Linux install instructions
This commit is contained in:
Andy Schwartzmeyer 2016-07-27 13:48:19 -07:00 committed by GitHub
parent dc9a0dd54c 2260cf7469
commit ded54be0ea
1 changed files with 40 additions and 27 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

67
docs/installation/linux.md
View file

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