2015-10-14 05:33:09 -04:00
# Getting Started with Dokku
2014-10-04 04:24:22 -04:00
2015-10-14 05:33:09 -04:00
## What is Dokku?
2014-10-04 04:24:22 -04:00
2015-10-14 05:33:09 -04:00
Dokku is an extensible, open source Platform as a Service that runs on a single server of your choice.
2014-10-04 04:24:22 -04:00
2016-01-07 13:21:43 +02:00
To start using Dokku, you'll need a system that meets the following minimum requirements:
2014-10-04 04:24:22 -04:00
2015-10-14 05:33:09 -04:00
- A fresh installation of [Ubuntu 14.04 x64 ](http://www.ubuntu.com/download/ ) with the FQDN set <sup>[1]</sup>
- At least `1GB` of system memory <sup>[2]</sup>
2014-10-04 04:24:22 -04:00
2015-10-14 05:33:09 -04:00
You can * optionally * have a domain name pointed at the host's IP, though this is not necessary.
Dokku is designed for usage on a fresh installation of Ubuntu, and should install all necessary dependencies if installing via the bootstrap method.
### Installing the latest stable version
2016-03-30 19:19:58 +02:00
#### 1. Install dokku
2015-10-14 05:33:09 -04:00
To install the latest stable version of dokku, you can run the following shell commands:
2014-10-04 04:24:22 -04:00
2014-12-19 15:09:38 -05:00
```shell
2016-09-03 04:39:12 -04:00
# for debian systems, installs Dokku via apt-get
2017-01-08 17:22:30 -07:00
wget https://raw.githubusercontent.com/dokku/dokku/v0.8.0/bootstrap.sh;
sudo DOKKU_TAG=v0.8.0 bash bootstrap.sh
2014-10-04 04:24:22 -04:00
```
2015-10-14 05:33:09 -04:00
The installation process takes about 5-10 minutes, depending upon internet connection speed.
2016-03-30 19:19:58 +02:00
#### 2. Setup SSH key and Virtualhost Settings
2016-09-03 04:39:12 -04:00
Once the installation is complete, you can open a browser to setup your SSH key and virtualhost settings. Open your browser of choice and navigate to the host's IP address - or the domain you assigned to that IP previously - and configure Dokku via the web admin.
2015-10-14 05:33:09 -04:00
2016-09-29 14:53:20 +05:30
>**Warning:** If you don't complete setup via the web installer (even if you set up SSH keys and virtual hosts otherwise) your Dokku installation will remain vulnerable to anyone finding the setup page and inserting their key.
2016-05-25 14:07:48 +02:00
2016-03-30 19:19:58 +02:00
#### 3. Deploy your first application
2016-09-03 04:39:12 -04:00
Once you save your settings, the web admin will self-terminate and you should be able to run or deploy to the Dokku installation.
2015-10-14 05:33:09 -04:00
### Installing via other methods
2015-02-18 02:26:12 -05:00
For various reasons, certain hosting providers may have other steps that should be preferred to the above. If hosted on any of the following popular hosts, please follow the linked to instructions:
2014-10-04 04:24:22 -04:00
2016-02-21 03:12:41 -05:00
- [Digital Ocean Installation Notes ](/dokku/getting-started/install/digitalocean )
2016-07-13 10:54:26 -07:00
- [DreamHost Cloud Installation Notes ](/dokku/getting-started/install/dreamhost/ )
2016-02-21 03:12:41 -05:00
- [Linode Installation Notes ](/dokku/getting-started/install/linode/ )
- [Microsoft Azure Installation Notes ](/dokku/getting-started/install/azure/ )
2014-10-04 04:24:22 -04:00
2015-02-18 02:26:12 -05:00
As well, you may wish to customize your installation in some other fashion. or experiment with vagrant. The guides below should get you started:
2014-10-04 04:24:22 -04:00
2016-07-04 22:59:50 -04:00
- [Debian Package Installation Notes ](/dokku/getting-started/install/debian/ )
2016-09-23 22:44:58 +03:00
- [RPM Package Installation Notes ](/dokku/getting-started/install/rpm/ )
2016-07-04 22:59:50 -04:00
- [Vagrant Installation Notes ](/dokku/getting-started/install/vagrant/ )
- [Advanced Install Customization ](/dokku/getting-started/advanced-installation/ )
2015-10-14 05:33:09 -04:00
---
- <sup>[1]: To check whether your system has an fqdn set, run `sudo hostname -f` </sup>
2016-07-04 22:59:50 -04:00
- <sup>[2]: If your system has less than 1GB of memory, you can use [this workaround ](/dokku/getting-started/advanced-installation/#vms-with-less-than-1gb-of-memory ).</sup>
