Browse Source

Merge pull request #562 from ariddell/feature/jessie-docs

DOC: sudo is not installed by default on jessie
Mike Ashley 8 years ago
parent
commit
2f9729617a
1 changed files with 11 additions and 7 deletions
  1. 11
    7
      README.md

+ 11
- 7
README.md View File

62
 Installation
62
 Installation
63
 ------------
63
 ------------
64
 
64
 
65
-### 1. Get a Tarsnap machine key
65
+### 1. Install required packages
66
+
67
+    apt-get install sudo
68
+
69
+### 2. Get a Tarsnap machine key
66
 
70
 
67
 If you haven’t already, [download and install Tarsnap](https://www.tarsnap.com/download.html), or use `brew install tarsnap` if you use [Homebrew](http://brew.sh).
71
 If you haven’t already, [download and install Tarsnap](https://www.tarsnap.com/download.html), or use `brew install tarsnap` if you use [Homebrew](http://brew.sh).
68
 
72
 
70
 
74
 
71
     tarsnap-keygen --keyfile roles/tarsnap/files/decrypted_tarsnap.key --user me@example.com --machine example.com
75
     tarsnap-keygen --keyfile roles/tarsnap/files/decrypted_tarsnap.key --user me@example.com --machine example.com
72
 
76
 
73
-### 2. Prep the server
77
+### 3. Prep the server
74
 
78
 
75
 For goodness sake, change the root password:
79
 For goodness sake, change the root password:
76
 
80
 
93
 
97
 
94
 Your new account will be automatically set up for passwordless `sudo`.
98
 Your new account will be automatically set up for passwordless `sudo`.
95
 
99
 
96
-### 3. Configure your installation
100
+### 4. Configure your installation
97
 
101
 
98
 Modify the settings in `vars/user.yml` to your liking. If you want to see how they’re used in context, just search for the corresponding string.
102
 Modify the settings in `vars/user.yml` to your liking. If you want to see how they’re used in context, just search for the corresponding string.
99
 
103
 
145
 
149
 
146
 Finally, replace the TODOs in the file `hosts`. If your SSH daemon listens on a non-standard port, add a colon and the port number after the IP address. In that case you also need to add your custom port to the task `Set firewall rules for web traffic and SSH` in the file `roles/common/tasks/ufw.yml`.
150
 Finally, replace the TODOs in the file `hosts`. If your SSH daemon listens on a non-standard port, add a colon and the port number after the IP address. In that case you also need to add your custom port to the task `Set firewall rules for web traffic and SSH` in the file `roles/common/tasks/ufw.yml`.
147
 
151
 
148
-### 4. Set up DNS
152
+### 5. Set up DNS
149
 
153
 
150
 If you’ve just bought a new domain name, point it at [Linode’s DNS Manager](https://library.linode.com/dns-manager) or similar. Most VPS services (and even some domain registrars) offer a managed DNS service that you can use for this at no charge. If you’re using an existing domain that’s already managed elsewhere, you can probably just modify a few records.
154
 If you’ve just bought a new domain name, point it at [Linode’s DNS Manager](https://library.linode.com/dns-manager) or similar. Most VPS services (and even some domain registrars) offer a managed DNS service that you can use for this at no charge. If you’re using an existing domain that’s already managed elsewhere, you can probably just modify a few records.
151
 
155
 
160
 * `cloud.example.com` (for ownCloud)
164
 * `cloud.example.com` (for ownCloud)
161
 * `git.example.com` (for cgit)
165
 * `git.example.com` (for cgit)
162
 
166
 
163
-### 5. Run the Ansible Playbooks
167
+### 6. Run the Ansible Playbooks
164
 
168
 
165
 First, make sure you’ve [got Ansible 1.9.3+ installed](http://docs.ansible.com/intro_installation.html#getting-ansible).
169
 First, make sure you’ve [got Ansible 1.9.3+ installed](http://docs.ansible.com/intro_installation.html#getting-ansible).
166
 
170
 
176
 
180
 
177
 The `dependencies` tag just installs dependencies, performing no other operations. The tasks associated with the `dependencies` tag do not rely on the user-provided settings that live in `vars/user.yml`. Running the playbook with the `dependencies` tag is particularly convenient for working with Docker images.
181
 The `dependencies` tag just installs dependencies, performing no other operations. The tasks associated with the `dependencies` tag do not rely on the user-provided settings that live in `vars/user.yml`. Running the playbook with the `dependencies` tag is particularly convenient for working with Docker images.
178
 
182
 
179
-### 6. Finish DNS set-up
183
+### 7. Finish DNS set-up
180
 
184
 
181
 Create an `MX` record for `example.com` which assigns `mail.example.com` as the domain’s mail server.
185
 Create an `MX` record for `example.com` which assigns `mail.example.com` as the domain’s mail server.
182
 
186
 
188
 
192
 
189
 Set up SPF and reverse DNS [as per this post](http://sealedabstract.com/code/nsa-proof-your-e-mail-in-2-hours/). Make sure to validate that it’s all working, for example by sending an email to <a href="mailto:check-auth@verifier.port25.com">check-auth@verifier.port25.com</a> and reviewing the report that will be emailed back to you.
193
 Set up SPF and reverse DNS [as per this post](http://sealedabstract.com/code/nsa-proof-your-e-mail-in-2-hours/). Make sure to validate that it’s all working, for example by sending an email to <a href="mailto:check-auth@verifier.port25.com">check-auth@verifier.port25.com</a> and reviewing the report that will be emailed back to you.
190
 
194
 
191
-### 7. Miscellaneous Configuration
195
+### 8. Miscellaneous Configuration
192
 
196
 
193
 Sign in to the ZNC web interface and set things up to your liking. It isn’t exposed through the firewall, so you must first set up an SSH tunnel:
197
 Sign in to the ZNC web interface and set things up to your liking. It isn’t exposed through the firewall, so you must first set up an SSH tunnel:
194
 
198
 

Loading…
Cancel
Save