doc/install_on_debian.md

46 lines
1.6 KiB
Markdown
Raw Normal View History

2013-12-29 00:06:11 +01:00
# Installation guide on Debian
2013-12-28 23:00:27 +01:00
2013-12-29 00:06:11 +01:00
You have two ways to install Yunohost:
2013-12-28 23:00:27 +01:00
2014-01-01 16:28:01 +01:00
1. [From a USB key or a CD-ROM](#/install)
2. With the install script on an existing Debian system (guide below)
2013-12-28 23:00:27 +01:00
2013-12-29 00:06:11 +01:00
### Pre-requisite
A box, a VPS, or a dedicated server:
2013-12-28 23:00:27 +01:00
2013-12-29 00:06:11 +01:00
* with Debian 7 (Wheezy, Raspbian, Cubian, etc.) installed
2014-01-01 16:28:01 +01:00
* connected to the Internet
* with root access or sudoer via SSH
2013-12-28 23:00:27 +01:00
2013-12-29 00:06:11 +01:00
### Installation
2013-12-28 23:00:27 +01:00
1. Connect to your Debian system through ssh
2013-12-28 23:00:27 +01:00
```bash
2013-12-29 00:06:11 +01:00
ssh root@monserveur.org
2013-12-28 23:00:27 +01:00
```
2013-12-29 00:06:11 +01:00
2. Install git
2013-12-28 23:00:27 +01:00
```bash
2013-12-29 00:06:11 +01:00
apt-get install git
2013-12-28 23:00:27 +01:00
```
2014-01-01 16:28:01 +01:00
3. Clone the Yunohost install script repository
2013-12-28 23:00:27 +01:00
```bash
2013-12-29 00:06:11 +01:00
git clone https://github.com/YunoHost/install_script /tmp/install_script
2013-12-28 23:00:27 +01:00
```
4. Execute the installation script
2013-12-28 23:00:27 +01:00
```bash
2013-12-29 00:06:11 +01:00
cd /tmp/install_script && ./install_yunohostv2
2013-12-28 23:00:27 +01:00
```
2013-12-29 00:06:11 +01:00
### Post-install
2014-01-01 16:28:01 +01:00
Once the installation is finished, the script will ask you for two options to complete the installation:
2013-12-29 00:06:11 +01:00
2014-01-01 16:28:01 +01:00
1. **domain name**: Please choose the domain name which will point to your Yunohost IP. You can choose to use a subdomain of **nohost.me** or **noho.st**, in that case the DNS configuration will be automatic, you will just have to wait three minutes to the end of the post-install. Or you can use your own [properly configured domain name](#/dns)
2013-12-29 00:06:11 +01:00
2014-01-01 16:28:01 +01:00
2. **administrator password**: this is the password to administer your Yunohost instance, **make it strong** and don't share it, without it you can lose access to your system.
2013-12-29 00:06:11 +01:00
2014-01-01 16:28:01 +01:00
After the installation is complete, you will be able to access your administration [web interface](#/admin) **https://your-domain.org/ynhadmin**, or to administer your Yunohost via the command-line interface called "[moulinette](#/moulinette)".